Skip to main content
GET
Read a connector status

Authorizations

Authorization
string
header
required

Obtain a token via the CLI auth flow (POST /v1/auth/sessions) or GitHub OAuth

Path Parameters

workspace_id
string
required

UUIDv7 of the workspace.

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.