List a project's installations

Every installation the project holds, live and standby, oldest first.

curl https://api.subscriby.net/v1/projects/7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13/connectors \  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

role is live for the one that acts and standby for the spare the Disaster Recovery Program keeps; state is pending, connected, degraded (the health probe found something wrong, state_reason and state_detail say what, creator_actionable whether the creator can fix it), revoked (the platform withdrew it) or disconnected (the creator did); operational is the one-word answer to "can it act right now?". external_id, display_name, handle and avatar_url are the platform's own account for the installation. Credentials and settings are never serialised.

sales_paused and outage describe a connector outage: the platform refused this live installation outright (token revoked or regenerated, bot deleted). While sales_paused is true, outage carries the outage's id, the connector's reason code and started_at, and every plan that unlocks a place on this connector is refused at checkout with 422 VALIDATION_FAILED; both go back to false and null when the installation answers again, is replaced or is uninstalled. Connector outages describes what members see and how they are compensated; connector.outage_opened and connector.outage_closed announce both ends.

Requires ability

project-connector:view-any

The token must hold this ability, or the call is refused with 403.

MCP tool

list_connector_installations

Runs the same action from an agent, behind the same ability.

Authorization

bearerToken

AuthorizationBearer <token>

A personal access token minted on the dashboard under Settings, then Tokens, sent as Authorization: Bearer sbt_live_…. The token carries the abilities each endpoint lists under Requires ability and is frozen to one team.

In: header

Path Parameters

project*string

The project, resolved by the route binder.

Formatuuid

Responses

200OKapplication/json

Array of ConnectorInstallationResource

data*array<>

The items.

401UnauthorizedAUTHENTICATION_REQUIREDapplication/json

The request carries no bearer token, or one that is revoked, malformed, or minted for another environment (an sbt_test_ token on production).

error*

The one envelope every failure uses.

403ForbiddenTOKEN_MISSING_ABILITYapplication/json

The token is valid but does not carry the ability this endpoint requires; error.context.required_ability names the one to grant. An endpoint that also checks who owns a row or which tier the account is on answers FORBIDDEN, TEAM_TIER_REQUIRED or CONNECTOR_TIER_REQUIRED with the same status, and says so in its own description.

error*

The one envelope every failure uses.

404Not foundRESOURCE_NOT_FOUNDapplication/json

An id in the path names nothing the token can see. TENANT_MISMATCH: the project sits outside the token's scope:project: allow-list, or the token carries no team scope. Both answer 404 rather than 403 so that existence outside the token's scope cannot be inferred.

error*

The one envelope every failure uses.

429Too many requestsRATE_LIMITEDapplication/json

The token has spent its 300 requests a minute or 10,000 an hour; Retry-After says when the next one is accepted.

error*

The one envelope every failure uses.

Call it from your code

A sample request in your language, the body each status answers with, and the types to hold them.

curl -X GET "https://example.com/v1/projects/497f6eca-6276-4993-bfeb-53cbbbba6f08/connectors"

{  "data": [    {      "id": "3b8f0c6e-2d41-4a97-9e5f-1c7d6b2a8e40",      "connector": "example",      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",      "scope": "project",      "role": "live",      "state": "connected",      "state_reason": null,      "state_detail": null,      "creator_actionable": false,      "operational": true,      "external_id": "7123456789",      "display_name": "Research Bot",      "handle": "research_bot",      "avatar_url": null,      "health_checked_at": "2026-09-12T06:00:00Z",      "doctor_ran_at": "2026-09-12T06:00:00Z",      "doctor_healthy": true,      "connected_at": "2026-04-21T09:15:00Z",      "verified_at": "2026-09-12T06:00:00Z",      "revoked_at": null,      "disconnected_at": null,      "uninstalled_at": null,      "created_at": "2026-04-21T09:15:00Z",      "capabilities": {        "messaging": {          "enabled": true,          "toggleable": true        },        "access_control": {          "enabled": true,          "toggleable": false        }      },      "sales_paused": false,      "outage": null    }  ]}

Type definitions

The shapes above as types, ready to paste into your client.

export interface Response {  data: ConnectorInstallationResource[];}export interface ConnectorInstallationResource {  id: string;  connector: string;  project_id: string | null;  scope: string;  role: string;  state: string;  state_reason: string | null;  state_detail: string | null;  creator_actionable: boolean;  operational: boolean;  external_id: string | null;  display_name: string | null;  handle: string | null;  avatar_url: string | null;  health_checked_at: string | null;  doctor_ran_at: string | null;  doctor_healthy: boolean | null;  connected_at: string | null;  verified_at: string | null;  revoked_at: string | null;  disconnected_at: string | null;  uninstalled_at: string | null;  created_at: string | null;  capabilities: Record<string, Capability>;  sales_paused: boolean;  outage: Outage | null;}export interface Capability {  enabled: boolean;  toggleable: boolean;}export interface Outage {  id: string;  reason: string;  started_at: string;}

List a project's installations

AuthorizationCopy Anchor Link

Path ParametersCopy Anchor Link

ResponsesCopy Anchor Link

Authorization

Path Parameters

Responses