Skip to main content
POST
Mint a command-line credential

Authorizations

Authorization
string
header
required

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

Body

application/json

POST /v1/cli-credentials — mint this machine's credential.

machine_name
string
required

The terminal's own label, as an operator will read it back.

Response

Created

The only response that returns a command-line credential in plaintext.

Save the value when you receive it. No later call returns it again.

credential
string
required

The credential itself. Shown once and never stored in this shape.

deployment
string
required

The deployment that minted it — this daemon, never a caller's claim.

id
string
required

The credential row's identifier, which the revoke addresses it by.

machine_name
string
required

The terminal's label, echoed back as it was stored.