# List a team's connectors

Returns the connectors this team registered, each carrying the connections the calling credential may actually use — not every connection that exists on it.

GET`/v1/connectors`

## Authorization

`Authorization`Bearer token · headerrequired

\`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 · headerrequired

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

Scopes:`connectors:read`

## Query parameters

`limit`integerrequired

min 1 · max 100 · default: 20

`cursor`string

min length 1 · max length 4096

`query`string

min length 1 · max length 200

`source`string

Allowed:`openapi``graphql``mcp`

`team`string

min length 1 · max length 255

## Responses

### 200Response for status 200

`$schema`string<uri>

Canonical JSON Schema URL for this response body. The server also sends it in the \`Link: rel="describedby"\` response header.

`data`object\[\]required

Show propertiesHide properties

Array of `object`

`slug`stringrequired

Stable, team-unique connector slug. Also the namespace tools hang off.

`title`stringrequired

Display name, seeded from the source spec.

`description`string \| anyrequired

What this connector reaches, in one line. Agent-visible.

`source`stringrequired

The kind of tool source a connector reads: an OpenAPI spec, a GraphQL endpoint, or a remote MCP server.

Allowed:`openapi``graphql``mcp`

`sourceUrl`string \| anyrequired

Spec, endpoint, or MCP URL this connector was built from; null when it was registered from an inline spec.

`firstParty`booleanrequired

Built into Spacefast. First-party connectors cannot be edited or removed.

`presetId`string \| anyrequired

Curated preset this connector was created from, when it came from the catalog.

`authMethods`object\[\]required

Every way this connector can be authenticated.

Show propertiesHide properties

Array of `object`

`kind`stringrequired

`slug`stringrequired

Names this method when a connector offers more than one.

`label`stringrequired

What to call it in a connect form, in the provider's own words.

`scopes`string\[\]required

Scopes requested at authorization unless the caller narrows them.

`dynamicRegistration`booleanrequired

Whether the provider supports RFC 7591 dynamic client registration, so no client has to be pre-created.

`provider`stringrequired

Existing Spacefast credential this connector borrows, e.g. the GitHub App installation. Nothing to enter.

`toolCount`integerrequired

Tools this connector exposes after the last spec sync.

`connections`object\[\]required

Connections the calling credential may use — not every connection that exists on this connector.

Show propertiesHide properties

Array of `object`

`id`stringrequired

Connection id (\`cxn\_\`). This is also the first segment of every tool address it owns.

`connector`stringrequired

Slug of the connector this connection authenticates.

`owner`stringrequired

\`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`stringrequired

What people call this connection, e.g. "Linear (support)".

`description`string \| anyrequired

Agent-visible note on what this connection is for. Shown to models choosing between several.

`status`stringrequired

Derived connection state. Never stored, so it cannot drift from the credential it describes.

Allowed:`pending_authorization``active``degraded``needs_reauth``revoked`

`identityLabel`string \| anyrequired

Account label reported by the provider, when it identifies itself. Null until the first successful probe.

`credentialConfigured`booleanrequired

Whether a usable credential is stored. The credential itself is never returned by any endpoint.

`authMethod`string \| anyrequired

Slug of the connector auth method this connection used.

`scopes`string\[\]required

Scopes actually granted, when the provider reports them.

`isDefault`booleanrequired

Whether this is the connection an agent gets when it names the connector alone.

`toolCount`integerrequired

Tools reachable through this connection at the last sync.

`createdBy`string \| anyrequired

User who connected it; null for first-party connections Spacefast owns.

`lastCheckedAt`string<date-time> \| anyrequired

Last health probe.

`revokedAt`string<date-time> \| anyrequired

When it was disconnected. The credential is purged; the row tombstones.

`createdAt`string<date-time>required

`updatedAt`string<date-time>required

`specSyncedAt`string<date-time> \| anyrequired

Last time the source was fetched and tools rebuilt.

`pagination`objectrequired

Show propertiesHide properties

`nextCursor`string \| anyrequired

Opaque cursor for the next page; null when there are no more results.

`hasMore`booleanrequired

Whether another page exists after this one.

### Problem details (RFC 9457). Any 4xx/5xx response is one `application/problem+json` document.

`$schema`string<uri>

Canonical JSON Schema URL for this response body. The server also sends it in the \`Link: rel="describedby"\` response header.

`type`stringrequired

URL of the documentation page for this error. Derived from \`code\`.

`title`stringrequired

Human-readable name of the error type. Derived from \`code\`.

`status`integerrequired

HTTP status of the response, repeated in the body.

`detail`stringrequired

What went wrong in this request.

`code`stringrequired

Stable snake\_case error code. Match on this, not on \`detail\`.

`pointer`string

RFC 6901 JSON Pointer to the request field or batch entry that failed, for example \`/files/37/path\`. Present on validation failures.

`details`object

Machine-readable context keyed by the error code.

`suggestions`string\[\]

Recovery steps safe to show to a person.

`next`string\[\]

Commands or API requests to run next, usable as written.

`requestId`stringrequired

ID of this request, from the \`X-Request-Id\` header or generated. Quote it when contacting support.

## Try it

Server

### Base URLhttps://api.spacefast.com

Custom base URLOverrides the selected server when set.

### Authorization

Bearer tokenRemember on this deviceInclude my values in samples

### Parameters

`limit`query\*`cursor`query`query`query`source`query—openapigraphqlmcp`team`query

## Send

### Request

#### cURL

```bash
curl -X GET "https://api.spacefast.com/v1/connectors?limit=20" \ 
  -H "Authorization: Bearer YOUR_TOKEN"
```

#### JavaScript

```javascript
const response = await fetch("https://api.spacefast.com/v1/connectors?limit=20", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});
```

#### Python

```python
import requests

response = requests.get(
    "https://api.spacefast.com/v1/connectors?limit=20",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)
```

### Response

### 200default

```json
{
  "$schema": "http://example.com",
  "data": [\
    {\
      "slug": "string",\
      "title": "string",\
      "description": "string",\
      "source": "openapi",\
      "sourceUrl": "string",\
      "firstParty": true,\
      "presetId": "string",\
      "authMethods": [\
        {\
          "kind": "api_key",\
          "slug": "string",\
          "label": "string"\
        }\
      ],\
      "toolCount": -9007199254740991,\
      "connections": [\
        {\
          "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"\
        }\
      ],\
      "specSyncedAt": "2019-08-24T14:15:22Z",\
      "createdAt": "2019-08-24T14:15:22Z",\
      "updatedAt": "2019-08-24T14:15:22Z"\
    }\
  ],
  "pagination": {
    "nextCursor": "string",
    "hasMore": true
  }
}
```

### Error response

```json
{
  "$schema": "http://example.com",
  "type": "string",
  "title": "string",
  "status": -9007199254740991,
  "detail": "string",
  "code": "string",
  "pointer": "string",
  "details": {
    "property1": null,
    "property2": null
  },
  "suggestions": [\
    "string"\
  ],\
  "next": [\
    "string"\
  ],
  "requestId": "string"
}
```