Connectors

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

Request

  • Base URL: https://api.spacefast.com
  • URL: https://api.spacefast.com/v1/connectors/connections
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://api.spacefast.com/v1/auth/oauth2/authorize, token URL https://api.spacefast.com/v1/auth/oauth2/token; client credentials, token URL https://api.spacefast.com/v1/auth/oauth2/token, scopes: connectors:read)

Query parameters

limitinteger

Page size.

cursorstring

Opaque cursor from the previous page's nextCursor.

'team' | 'personal'

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.

OR
'any'
connectorstring

Show only connections of this connector.

status'pending_authorization' | 'active' | 'degraded' | 'needs_reauth' | 'revoked'

Show only connections in this state.

includeRevokedboolean

Include disconnected connections.

teamstring

Team id or slug to act for. Required only when the credential could act for more than one team.

Response

Response for status 200

$schemastring uri

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

Changes

No recorded changes to this operation across all 1 revision of this API.