Org Integrations

GET /api/orgs/{org_id}/integrations/check-slug

Check Slug Availability

Check whether a connection slug is valid and not yet taken in this org.

Used by the create/edit dialogs for live validation. Pass exclude_id to ignore the integration being edited when checking uniqueness.

Parameters

Name	In	Type	Required	Description
exclude_id	query	string (uuid)	no
org_id	path	string (uuid)	yes
slug	query	string	yes

Responses

Status	Description	Body
200	Successful Response	SlugCheckResponse
422	Validation Error	HTTPValidationError

GET /api/orgs/{org_id}/integrations/configured

List Configured Integrations

List the organization’s configured integrations.

Requires membership in the organization. Secret params are redacted.

Parameters

Name	In	Type	Required	Description
org_id	path	string (uuid)	yes

Responses

Status	Description	Body
200	Successful Response	ConfiguredIntegrationListResponse
422	Validation Error	HTTPValidationError

POST /api/orgs/{org_id}/integrations/configured

Create Configured Integration

Create a new configured integration.

Any org member may create integrations for now — see issue #260. Validates params against the registry.

For MCP_SERVER integrations the tool-definition cache is invalidated after creation so that the next tool-discovery read fetches fresh tool metadata from the upstream server.

Parameters

Name	In	Type	Required	Description
org_id	path	string (uuid)	yes

Request body (required)

Field	Type	Required	Description
app_name	string	no
description	string	no
integration_type	string	yes
name	string	yes
params	object	yes
scope	string	no
slug	string	no

Responses

Status	Description	Body
201	Successful Response	ConfiguredIntegrationResponse
422	Validation Error	HTTPValidationError

GET /api/orgs/{org_id}/integrations/configured/{integration_id}

Get Configured Integration

Get a single configured integration.

Requires membership in the organization. Secret params are redacted.

Parameters

Name	In	Type	Required	Description
integration_id	path	string (uuid)	yes
org_id	path	string (uuid)	yes

Responses

Status	Description	Body
200	Successful Response	ConfiguredIntegrationResponse
422	Validation Error	HTTPValidationError

PATCH /api/orgs/{org_id}/integrations/configured/{integration_id}

Update Configured Integration

Update a configured integration.

Any org member may update integrations for now — see issue #260. A PRIVATE row owned by someone else 404s. Params are merged (partial update).

For MCP_SERVER integrations the tool-definition cache is invalidated after a successful update so that stale metadata (e.g. from a URL or credential change) is not served to agents.

Parameters

Name	In	Type	Required	Description
integration_id	path	string (uuid)	yes
org_id	path	string (uuid)	yes

Request body (required)

Field	Type	Required	Description
app_name	string	no
description	string	no
name	string	no
params	object	no
slug	string	no
status	string	no

Responses

Status	Description	Body
200	Successful Response	ConfiguredIntegrationResponse
422	Validation Error	HTTPValidationError

DELETE /api/orgs/{org_id}/integrations/configured/{integration_id}

Delete Configured Integration

Delete a configured integration.

Any org member may delete integrations for now — see issue #260. A PRIVATE row owned by someone else 404s.

Parameters

Name	In	Type	Required	Description
integration_id	path	string (uuid)	yes
org_id	path	string (uuid)	yes

Responses

Status	Description	Body
204	Successful Response
422	Validation Error	HTTPValidationError

GET /api/orgs/{org_id}/integrations/types

List Integration Types

List available integration types from the registry.

Requires membership in the organization.

Parameters

Name	In	Type	Required	Description
org_id	path	string (uuid)	yes

Responses

Status	Description	Body
200	Successful Response	IntegrationTypeListResponse
422	Validation Error	HTTPValidationError