List a team's connectors - Spacefast Docs
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
AuthorizationBearer token · headerrequired
`Authorization: Bearer
or
AuthorizationOAuth2 access token · headerrequired
OAuth 2.0 with Spacefast scopes. People use the authorization code flow; machines use client credentials.
Scopes:connectors:read
Query parameters
limitintegerrequired
min 1 · max 100 · default: 20
cursorstring
min length 1 · max length 4096
querystring
min length 1 · max length 200
sourcestring
Allowed:openapi``graphql``mcp
teamstring
min length 1 · max length 255
Responses
200Response for status 200
$schemastring
Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
dataobject[]required
Show propertiesHide properties
Array of object
slugstringrequired
Stable, team-unique connector slug. Also the namespace tools hang off.
titlestringrequired
Display name, seeded from the source spec.
descriptionstring | anyrequired
What this connector reaches, in one line. Agent-visible.
sourcestringrequired
The kind of tool source a connector reads: an OpenAPI spec, a GraphQL endpoint, or a remote MCP server.
Allowed:openapi``graphql``mcp
sourceUrlstring | anyrequired
Spec, endpoint, or MCP URL this connector was built from; null when it was registered from an inline spec.
firstPartybooleanrequired
Built into Spacefast. First-party connectors cannot be edited or removed.
presetIdstring | anyrequired
Curated preset this connector was created from, when it came from the catalog.
authMethodsobject[]required
Every way this connector can be authenticated.
Show propertiesHide properties
Array of object
kindstringrequired
slugstringrequired
Names this method when a connector offers more than one.
labelstringrequired
What to call it in a connect form, in the provider's own words.
scopesstring[]required
Scopes requested at authorization unless the caller narrows them.
dynamicRegistrationbooleanrequired
Whether the provider supports RFC 7591 dynamic client registration, so no client has to be pre-created.
providerstringrequired
Existing Spacefast credential this connector borrows, e.g. the GitHub App installation. Nothing to enter.
toolCountintegerrequired
Tools this connector exposes after the last spec sync.
connectionsobject[]required
Connections the calling credential may use — not every connection that exists on this connector.
Show propertiesHide properties
Array of object
idstringrequired
Connection id (`cxn_`). This is also the first segment of every tool address it owns.
connectorstringrequired
Slug of the connector this connection authenticates.
ownerstringrequired
`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
displayNamestringrequired
What people call this connection, e.g. "Linear (support)".
descriptionstring | anyrequired
Agent-visible note on what this connection is for. Shown to models choosing between several.
statusstringrequired
Derived connection state. Never stored, so it cannot drift from the credential it describes.
Allowed:pending_authorization``active``degraded``needs_reauth``revoked
identityLabelstring | anyrequired
Account label reported by the provider, when it identifies itself. Null until the first successful probe.
credentialConfiguredbooleanrequired
Whether a usable credential is stored. The credential itself is never returned by any endpoint.
authMethodstring | anyrequired
Slug of the connector auth method this connection used.
scopesstring[]required
Scopes actually granted, when the provider reports them.
isDefaultbooleanrequired
Whether this is the connection an agent gets when it names the connector alone.
toolCountintegerrequired
Tools reachable through this connection at the last sync.
createdBystring | anyrequired
User who connected it; null for first-party connections Spacefast owns.
lastCheckedAtstring
Last health probe.
revokedAtstring
When it was disconnected. The credential is purged; the row tombstones.
createdAtstring
updatedAtstring
specSyncedAtstring
Last time the source was fetched and tools rebuilt.
paginationobjectrequired
Show propertiesHide properties
nextCursorstring | anyrequired
Opaque cursor for the next page; null when there are no more results.
hasMorebooleanrequired
Whether another page exists after this one.
Problem details (RFC 9457). Any 4xx/5xx response is one application/problem+json document.
$schemastring
Canonical JSON Schema URL for this response body. The server also sends it in the `Link: rel="describedby"` response header.
typestringrequired
URL of the documentation page for this error. Derived from `code`.
titlestringrequired
Human-readable name of the error type. Derived from `code`.
statusintegerrequired
HTTP status of the response, repeated in the body.
detailstringrequired
What went wrong in this request.
codestringrequired
Stable snake_case error code. Match on this, not on `detail`.
pointerstring
RFC 6901 JSON Pointer to the request field or batch entry that failed, for example `/files/37/path`. Present on validation failures.
detailsobject
Machine-readable context keyed by the error code.
suggestionsstring[]
Recovery steps safe to show to a person.
nextstring[]
Commands or API requests to run next, usable as written.
requestIdstringrequired
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
limitquery*cursorqueryqueryquerysourcequery—openapigraphqlmcpteamquery
Send
Request
cURL
curl -X GET "https://api.spacefast.com/v1/connectors?limit=20" \
-H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const response = await fetch("https://api.spacefast.com/v1/connectors?limit=20", {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_TOKEN"
}
});
Python
import requests
response = requests.get(
"https://api.spacefast.com/v1/connectors?limit=20",
headers={
"Authorization": "Bearer YOUR_TOKEN"
},
)
Response
200default
{
"$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
{
"$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"
}