Start the Device Authorization Grant (RFC 8628)

Public endpoint (no auth): credential bootstrap for the Device Authorization Grant (RFC 8628).

POST/auth/device/code

Responses

200

Flow started: device_code (polled by the CLI) + user_code (approved by the user in the browser).

device_codestringrequired

user_codestringrequired

verification_uristringrequired

verification_uri_completestringrequired

expires_inintegerrequired

min -9007199254740991 · max 9007199254740991

intervalintegerrequired

min -9007199254740991 · max 9007199254740991

429

Too many requests from the same IP (anti-flood).

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

detailsany

503

Could not generate a unique device_code/user_code after retrying (persistent collision).

errorobjectrequired

Show properties

codestringrequired

messagestringrequired

retryablebooleanrequired

detailsany

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Request

curl -X POST 'https://admin.appfreeticket.com/api/v1/auth/device/code'

const response = await fetch("https://admin.appfreeticket.com/api/v1/auth/device/code", {
  method: "POST"
});

import requests

response = requests.post(
    "https://admin.appfreeticket.com/api/v1/auth/device/code",
)

Response

{
  "device_code": "string",
  "user_code": "string",
  "verification_uri": "string",
  "verification_uri_complete": "string",
  "expires_in": -9007199254740991,
  "interval": -9007199254740991
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}

{
  "error": {
    "code": "string",
    "message": "string",
    "retryable": true,
    "details": null
  }
}