Update a connector

Renames a connector, replaces its agent-visible description, or re-fetches its source and rebuilds the tool catalog. Connections and policy rules survive a refresh.

PATCH /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:write

Path parameters

connectorRef string required

• min length 1

Query parameters

team string

• min length 1 · max length 255

Request body

required application/json

• title string
  • Replacement display name.
  • min length 1 · max length 255
• description string | any
  • Replacement agent-visible description.
• refreshSpec boolean
  • Re-fetch the source and rebuild the tool catalog. Connections and policy rules survive it.
• specOverrides object[]
  • Replacement RFC 6902 JSON Patch operations. Applied on the next spec build.
  • max items 200

Responses

200 Response for status 200

• $schema string
  • Canonical JSON Schema URL for this response body. The server also sends it in the Link: rel="describedby" response header.
• 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.
• 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.
• 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.
• authMethods object[] required
  • Every way this connector can be authenticated.

Show properties

• kind string required
  • Names this method when a connector offers more than one.
• slug string required
  • Names this method when a connector offers more than one.
• label string required
  • What to call it in a connect form, in the provider's own words.
• scopes string[] required
  • Scopes requested at authorization unless the caller narrows them.
• dynamicRegistration boolean required
  • Whether the provider supports RFC 7591 dynamic client registration, so no client has to be pre-created.

Connections

• 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.
  • 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
• 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.
• 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.
• createdAt string required
  • Token for connection created date.

Example Request

curl -X PATCH "https://api.spacefast.com/v1/connectors/string" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "title": "string",
  "description": "string",
  "refreshSpec": true,
  "specOverrides": [
    {
      "property1": null,
      "property2": null
    }
  ]
}'

Example Response

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