Integrations API

Endpoints for managing source control integrations (GitHub and GitLab). All endpoints require a valid user session.

List Integrations

GET /v1/integrations

Authentication: User session (Bearer)

Response 200 OK

[
  {
    "id": "int_abc123",
    "provider": "github",
    "host_url": "https://github.com",
    "auth_mode": "github_app",
    "status": "active",
    "display_name": "My GitHub App",
    "app_id": "123456",
    "app_slug": "oore-build-ci",
    "created_by": "user_def456",
    "created_at": 1738800000,
    "updated_at": 1738800000
  }
]

---

Get Integration

GET /v1/integrations/{id}

Authentication: User session (Bearer)

---

Delete Integration

DELETE /v1/integrations/{id}

Authentication: User session (Bearer)

---

List Repositories

List repositories accessible through an integration.

GET /v1/integrations/{id}/repositories

Authentication: User session (Bearer)

Response 200 OK

Returns an array of repository objects with name, URL, and visibility.

---

GitHub Integration

Start GitHub App Creation

POST /v1/integrations/github/start

Initiates the GitHub App creation flow. Returns a URL to redirect the user to GitHub.

Complete GitHub App Setup

POST /v1/integrations/github/complete

Completes the GitHub App OAuth flow after GitHub redirects back.

GitHub Callback (internal)

GET /v1/integrations/github/callback

Handles the OAuth callback from GitHub. This endpoint is called by GitHub, not directly by the UI.

GitHub Installed (internal)

GET /v1/integrations/github/installed

Handles the post-installation callback from GitHub.

GitHub Create Page (internal)

GET /v1/integrations/github/create

Serves the GitHub App creation page.

List Installations

GET /v1/integrations/{id}/installations

List GitHub App installations for this integration.

Sync Installations

POST /v1/integrations/{id}/installations

Force sync installation data from GitHub.

---

GitLab Integration

Start GitLab OAuth

POST /v1/integrations/gitlab/start

Initiates the GitLab OAuth flow. Provide the GitLab host URL and OAuth credentials.

Authorize GitLab

POST /v1/integrations/gitlab/authorize

Completes the GitLab OAuth authorization.

GitLab Callback (internal)

GET /v1/integrations/gitlab/callback

Handles the OAuth callback from GitLab.

---

Webhooks

Webhook endpoints are outside the CORS-protected API group. They are called by external services.

GitHub Webhook

POST /v1/webhooks/github

Authentication: GitHub webhook signature verification

Receives push and pull request events from GitHub. Triggers builds for matching pipelines.

GitLab Webhook

POST /v1/webhooks/gitlab

Authentication: GitLab webhook secret token

Receives push and merge request events from GitLab. Triggers builds for matching pipelines.