v2

latestOpenAPI 3.1.02026-07-2615946107.7 KB

Auth

Start CLI device login

RFC-8628-style device authorization for CLI/agents. No auth required. Optional expected_email pre-selects the Google account and drives a mismatch warning on approval.

post/v1/auth/device/start

Request body

expected_emailstring email

Email the user expects to sign in as (e.g. invite address).

Response

Pending device authorization

device_codestring required

Secret held by the CLI for polling.

user_codestring required

Short code shown in the browser (e.g. XXXX-XXXX).

verification_uristring uri required

verification_uri_completestring uri required

intervalinteger required

Minimum poll interval in seconds.

expires_ininteger required

Seconds until the code expires.