Skip to main content
POST
Create a command-line credential

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.

Body

application/json

Request to create this machine's command-line 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

Deployment that issued this credential, assigned by the server.

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.