Skip to main content
POST
Connect an Anthropic subscription

Authorizations

Authorization
string
header
required

A workspace-bound human user OAuth grant with org:write scope. The user must be an organization owner/admin. API keys and browser sessions are not accepted.

Path Parameters

orgId
string
required

Organization id or slug. Resolve it with GET /v3/self.

Body

application/json

Either setup_token, or access_token, refresh_token and expires_at together.

access_token
string

Anthropic OAuth access token, with refresh_token and expires_at. Write-only; never returned.

Maximum string length: 8192
refresh_token
string

Anthropic OAuth refresh token. Write-only; never returned.

Maximum string length: 8192
expires_at
string<date-time>
setup_token
string

Instead of the three OAuth fields: the long-lived token Claude Code's claude setup-token prints (sk-ant-oat…). It has no refresh token, so it is never refreshed; it lasts a year. Write-only; never returned.

Maximum string length: 8192
account_key
string

Existing Anthropic account slot to reconnect.

Required string length: 1 - 512

Response

Anthropic is connected.

provider_id
string
required
Allowed value: "anthropic"
account_key
string
required
connected
boolean
required
credential_type
string
required
Allowed value: "oauth"