# 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** <uri>  
  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<date-time> | any** required  
    Last health probe.
  - **`revokedAt`** **string<date-time> | any** required  
    When it was disconnected. The credential is purged; the row tombstones.
  - **`createdAt`** **string<date-time> required**
  - **`updatedAt`** **string<date-time> 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

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

### Example Response

```json
{
  "$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
  }
}
```