CLI Auth

Begin a CLI device-authorization login (RFC 8628)

Public, unauthenticated. Mints a device code (returned once) and a short human user code, and returns the verification URIs the user opens in a browser to approve. The CLI then polls /auth/cli/poll. Rate-limited per client IP.

post/auth/cli/start

Request

  • Base URL: https://krova.cloud/api/v1
  • URL: https://krova.cloud/api/v1/auth/cli/start
  • Auth: none required

Response

Device-authorization request created

deviceCodestring required

High-entropy code the CLI keeps secret and presents on each poll. Only its hash is stored server-side.

userCodestring required

Short human-readable code (KROVA-XXXX-XXXX) the user confirms in the browser.

verificationUristring uri required

Browser URL where the user approves.

verificationUriCompletestring uri required

verificationUri with the user code pre-filled.

intervalinteger required

Seconds to wait between polls.

expiresIninteger required

Seconds until the device code expires (~600).

Changes

No recorded changes to this operation across all 1 revision of this API.