ReferenceAPI reference
Integrations
4 operations in the Integrations group.
3 of 4 operations on this page are generated contract stubs: the routes are real, the schemas are placeholders pending the owning subsystem's contract pass.
GET /api/integrations/github/repositories
Generated contract stub — the route is real and served, but its request/response schema has not been hand-tightened yet.
Operation ID: getApiIntegrationsGithubRepositories
Responses
| Status | Description | Schema |
|---|---|---|
| 200 | Successful response | GenericApiResponse |
| 401 | Authentication is required | ErrorEnvelope |
| 403 | Permission denied | ErrorEnvelope |
| 422 | Validation failed | ErrorEnvelope |
| 500 | Server error | ErrorEnvelope |
GET /api/integrations/oauth/{provider}/callback
Generated contract stub — the route is real and served, but its request/response schema has not been hand-tightened yet.
Operation ID: getApiIntegrationsOauthProviderCallback
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
provider | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
| 200 | Successful response | GenericApiResponse |
| 401 | Authentication is required | ErrorEnvelope |
| 403 | Permission denied | ErrorEnvelope |
| 422 | Validation failed | ErrorEnvelope |
| 500 | Server error | ErrorEnvelope |
POST /api/integrations/webhooks/{endpoint}
Generated contract stub — the route is real and served, but its request/response schema has not been hand-tightened yet.
Operation ID: postApiIntegrationsWebhooksEndpoint
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
endpoint | path | yes | string |
Request body — application/json · object
Responses
| Status | Description | Schema |
|---|---|---|
| 200 | Successful response | GenericApiResponse |
| 201 | Successful response | GenericApiResponse |
| 401 | Authentication is required | ErrorEnvelope |
| 403 | Permission denied | ErrorEnvelope |
| 422 | Validation failed | ErrorEnvelope |
| 500 | Server error | ErrorEnvelope |
POST /api/resources/{workspace}/provider-oauth/{provider}/start
Operation ID: startProviderOAuth
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
workspace | path | yes | string | |
provider | path | yes | enum(github, slack, linear) |
Request body — application/json · ProviderOAuthStartRequest
| Field | Type | Required |
|---|---|---|
return_to | `string | null` |
Responses
| Status | Description | Schema |
|---|---|---|
| 200 | Returns a provider authorization URL for a workspace-scoped OAuth or app-install flow. Secrets are never returned. | ProviderOAuthStartResponse |
| 409 | Provider OAuth is not configured for this environment. | ProviderOAuthSetupRequiredResponse |