Initiate the device-code flow
curl --request POST \
--url https://breadbox.example.com/api/v1/auth/device-code{
"device_code": "<string>",
"user_code": "<string>",
"verification_url": "<string>",
"expires_in": 123,
"interval": 123
}Auth
Initiate the device-code flow
Mint a pending device-code pair. Unauthenticated — the device_code returned in the body is itself the credential the CLI uses to poll. The user_code is the human-facing 8-char approval code (formatted XXXX-XXXX) the operator enters on the verification page.
POST
/
api
/
v1
/
auth
/
device-code
Initiate the device-code flow
curl --request POST \
--url https://breadbox.example.com/api/v1/auth/device-code{
"device_code": "<string>",
"user_code": "<string>",
"verification_url": "<string>",
"expires_in": 123,
"interval": 123
}Documentation Index
Fetch the complete documentation index at: https://docs.breadbox.sh/llms.txt
Use this file to discover all available pages before exploring further.
Response
201 - application/json
Pending device-code created.
Opaque polling credential carried by the CLI
8-char human-facing code formatted XXXX-XXXX
URL the operator opens to approve
TTL in seconds (10 minutes by default)
Suggested polling cadence in seconds
⌘I