Skip to main content
POST
Connect with your own token

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

provider
string
required

The code host's key.

Body

application/json

A token the person made at the host themselves. Write-only.

token
string
required
Required string length: 8 - 512
host
string | null

The host this token is for, when a tenant has more than one instance of a provider. Taken from the repository's remote.

Maximum string length: 256
artifact_id
string | null

The repository this token is for. A repository's own token wins over one that covers the whole host; leaving it out connects the host, so one token covers every repository on it.

Response

Successful Response

One person's sign-in at one host, as a page may see it.

provider
string
required
label
string
required
connected
boolean
required
host
string
default:""
for_this_repository
boolean
default:false
can_sign_in
boolean
default:false
account
string
default:""
needs_reconnect
boolean
default:false
connected_at
string | null