List connections

Returns the connections the calling credential may use — team connections plus your own personal ones. A revoked connection is a tombstone and stays out unless you ask for it.

GET /v1/connectors/connections

Authorization

Authorization Bearer token · header required

Authorization: Bearer <token> with an API key (sfa_ prefix), an OAuth access token, a session token, or a Space machine credential (sfm_ prefix).

or

Authorization OAuth2 access token · header required

OAuth 2.0 with Spacefast scopes. People use the authorization code flow; machines use client credentials.

Scopes: connectors:read

Query parameters

• limit integer required
  min 1 · max 100 · default: 20
• cursor string
  min length 1 · max length 4096
• owner string required
  default: "any"
• connector string
  min length 1
• status string
  Allowed: pending_authorization, active, degraded, needs_reauth, revoked
• includeRevoked boolean required
  default: false
• team string
  min length 1 · max length 255

Responses

200 Response for status 200

• $schema string
  Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.

• data object[] required
  Array of object

• id string required
  Connection id (cxn_). This is also the first segment of every tool address it owns.

  • connector string required
    Slug of the connector this connection authenticates.
  • owner string required
    team is shared with everyone on the team; personal is yours, and only within this team — connecting the same account for another team is another connection. Allowed: team, personal
  • displayName string required
    What people call this connection, e.g. "Linear (support)".
  • description string | any required
    Agent-visible note on what this connection is for. Shown to models choosing between several.
  • status string required
    Derived connection state. Never stored, so it cannot drift from the credential it describes. Allowed: pending_authorization, active, degraded, needs_reauth, revoked
  • identityLabel string | any required
    Account label reported by the provider, when it identifies itself. Null until the first successful probe.
  • credentialConfigured boolean required
    Whether a usable credential is stored. The credential itself is never returned by any endpoint.
  • authMethod string | any required
    Slug of the connector auth method this connection used.
  • scopes string[] required
    Scopes actually granted, when the provider reports them.
  • isDefault boolean required
    Whether this is the connection an agent gets when it names the connector alone.
  • toolCount integer required
    Tools reachable through this connection at the last sync. min -9007199254740991 · max 9007199254740991
  • createdBy string | any required
    User who connected it; null for first-party connections Spacefast owns.
  • lastCheckedAt string | any required
    Last health probe.
  • revokedAt string | any required
    When it was disconnected. The credential is purged; the row tombstones.
  • createdAt string required
  • updatedAt string required

• pagination object required

  • nextCursor string | any required
    Opaque cursor for the next page; null when there are no more results.
  • hasMore boolean required
    Whether another page exists after this one.

Example Request

curl -X GET "https://api.spacefast.com/v1/connectors/connections?limit=20&owner=any&includeRevoked=false" \
  -H "Authorization: Bearer YOUR_TOKEN"

Example Response

{
  "$schema": "http://example.com",
  "data": [
    {
      "id": "string",
      "connector": "string",
      "owner": "team",
      "displayName": "string",
      "description": "string",
      "status": "pending_authorization",
      "identityLabel": "string",
      "credentialConfigured": true,
      "authMethod": "string",
      "scopes": [
        "string"
      ],
      "isDefault": true,
      "toolCount": -9007199254740991,
      "createdBy": "string",
      "lastCheckedAt": "2019-08-24T14:15:22Z",
      "revokedAt": "2019-08-24T14:15:22Z",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  }
}