Skip to main content
GET
Read a connector status

Authorizations

Authorization
string
header
required

Send a dashboard session token, an account API key (agt_t), or a command-line credential (afc_) as a Bearer token. Each endpoint lists accepted credential types.

Path Parameters

workspace_id
string
required

Workspace identifier (version 7 universally unique identifier, or UUID).

provider
string
required

Provider identifier, such as slack or github.

Response

OK

One provider's connection, as a status read returns it.

This response carries no access token and no expiry. It tells you whether someone connected this provider, and what the connection is called.

status
string
required

Whether this workspace holds a landed grant — [STATUS_CONNECTED] or [STATUS_NOT_CONNECTED].

label
string | null

What a person sees the connection called, when the grant named one.