Read one connector

Returns one connector with the connections the calling credential may use and the tools it currently exposes.

GET /v1/connectors/{connectorRef}

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

Path parameters

connectorRef string required

• min length 1

Query parameters

team string

• min length 1 · max length 255

Responses

200 Response for status 200

• $schema string
• data object required

A tool source registered for one team.

Show properties

• slug string required

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

• title string required

Display name, seeded from the source spec.

• description string | any required

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

Show properties

• source string required

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 | any required

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

Show properties

• firstParty boolean required

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

• presetId string | any required

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

Show properties

• authMethods object[] required

Every way this connector can be authenticated.

Show properties

Array of object

• kind string required
• slug string required
• label string required

Show properties

• scopes string[] required
• dynamicRegistration boolean required
• provider string required
• toolCount integer required

Connections

connections object[] required

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

Show properties

Array of object

• id string required
• connector string required
• owner string required
• displayName string required
• description string | any required
• status string required

Allowed: pending_authorization active degraded needs_reauth revoked

• identityLabel string | any required
• credentialConfigured boolean required
• authMethod string | any required
• scopes string[] required
• isDefault boolean required
• toolCount integer required
• createdBy string | any required
• lastCheckedAt string | any required
• revokedAt string | any required
• createdAt string required
• updatedAt string required
• specSyncedAt string | any required
• createdAt string required
• updatedAt string required

default Problem details (RFC 9457)

Any 4xx/5xx response is one application/problem+json document.