# 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<uri>
- `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<date-time> | any required
- `revokedAt` string<date-time> | any required
- `createdAt` string<date-time> required
- `updatedAt` string<date-time> required
- `specSyncedAt` string<date-time> | any required
- `createdAt` string<date-time> required
- `updatedAt` string<date-time> required

### default Problem details (RFC 9457)

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