Connectors

Connect a tracker or MCP connector

POST
/v1/connectors/{connectorId}/connect

Authorization

bearerAuth
AuthorizationBearer <token>

A personal API key (psk_…) or an OAuth access token (plan_at_…). Scopes: read, write.

In: header

Path Parameters

connectorId*string

Connector id, e.g. linear. Custom servers use the x_ prefix.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/connectors/string/connect" \  -H "Content-Type: application/json" \  -d '{}'
{  "mode": "workspace_key",  "connected": true,  "connector": "string",  "authorizeUrl": "string",  "remainingGrants": 0,  "message": "string"}