Skip to main content
POST
Start a command-line login session

Body

application/json
public_key
string
required

Base64url-encoded P-256 SubjectPublicKeyInfo. The CLI's ephemeral ECDH public key — used by the dashboard to derive the AES-256-GCM session key that wraps the JWT.

token_name
string
required

Operator-facing label for the resulting credential (e.g. macos-cli, linux-cli, windows-cli). Printable ASCII; appears in audit events and agentsfleet auth status.

Required string length: 1 - 64

Response

Auth session created

session_id
string<uuid>
required

UUIDv7 session identifier for approval and verification endpoints.

login_url
string<uri>
required

Browser approval URL for this login session.

request_id
string
required

Unique request identifier