Connectors

REST endpoints for connectors. Bearer-auth required.

GET /api/connectors

List connectors

List available connectors. Pass workspace_id to include connection status per connector.

Query parameters

• limit (optional): Max items per page (1–100, default 100).
• after (optional): Keyset cursor — return the page after this row (next page).
• before (optional): Keyset cursor — return the page before this row (prev page).
• ids (optional): Comma-separated IDs. Narrows results to these IDs within the caller's accessible scope (does not bypass access checks).
• workspace_id (optional): Include per-connector connection status for this workspace.
• enabled (optional): Filter to enabled (true) or disabled (false) connectors.

Response

"any"

GET /api/connectors/{id}

Get connector

Path parameters

• id (required): The connector's ID or slug.

Response

{
  "id": "string",
  "name": "string",
  "slug": "string",
  "description": "string",
  "iconUrl": "string",
  "mcpUrl": "string",
  "oauthScopes": "string",
  "configSchema": {},
  "enabled": "boolean",
  "createdAt": "string"
}

GET /api/connectors/{id}/connect

Initiate connector OAuth

Creates a pending MCP server and returns an OAuth authorization URL.

Path parameters

• id (required): The connector's ID or slug.

Query parameters

• workspace_id (required): The workspace the MCP server will belong to.
• config (optional): JSON-encoded connector-specific config (URL-encoded).

Response

{
  "authorizationUrl": "string",
  "mcpServerId": "string"
}