API keys

Start the RFC 8628 device-code flow. No auth.

Returns { device_code, user_code, verification_url, verification_url_complete, interval, expires_in }. Print verification_url_complete for the human, then poll. Codes live 10 minutes. Rate limited per IP.

post/api-keys/device-code

Request

  • Base URL: https://api.stacktr.ee
  • URL: https://api.stacktr.ee/api-keys/device-code
  • Auth: none required

Request body

client_hintstring

Names the agent in the human’s approval screen and in the key label.

Response

Codes issued.

device_codestring required

Secret. Send this on every poll; never show it to the human.

user_codestring required

Short code the human confirms on screen, e.g. "K3PQ-7RTM".

verification_urlstring uri required
verification_url_completestring uri

The URL to print: it carries the user_code already.

intervalinteger required

Seconds to wait between polls.

expires_ininteger required

Seconds until the code dies.

Changes

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