Skip to main content
GET
Get Connection

Path Parameters

connection_id
string
required

Response

Successful Response

connection_id
string
required

Unique identifier for the connection.

Example:

"conn_01abc123"

provider
string
required

Provider slug.

Example:

"slack"

resources
string[]
required

Resource slugs enabled for this connection.

Example:
connected_at
string | null

ISO 8601 timestamp of when the connection was created.

Example:

"2026-01-15T10:30:00Z"

team_name
string | null

Workspace or team display name from the provider.

Example:

"Acme Corp"

external_account_id
string | null

Account ID assigned by the provider.

Example:

"T01ABC123"

disabled_resources
string[]

Resource slugs turned off for this connection — by the setup wizard, the filters dialog, or connect-time credential verification. Excluded from status displays but still configurable (re-enableable).

Example:
source
string | null

Resource slug this connection is bound to, when it was connected as a single source (Gmail rather than Google). Such a connection carries exactly that resource; null for provider-wide connections.

Example:

"email"

name
string
default:""

Display name for the connection's source or provider.

Example:

"Gmail"

icon
string
default:""

Icon key for the source (falls back to the provider slug).

Example:

"gmail"

tools
ConnectionToolOut · object[]

MCP tools this connection can vend, with whether each is enabled and whether the connection's OAuth grant covers it. Empty when the workspace is not entitled to connection tools.