Introducing Agents.·Read
Getting StartedKey ConceptsHow-to GuidesCLITrickest SDKSandbox SDKAPI ReferenceChangelog
Start CLI device authorization

Start CLI device authorization

Creates a short-lived device code and user-facing verification code.

POST/api/auth/device/code
Body
client_idenumrequired

One of: trickest-cli

Request

curl
curl -X POST https://trickest.io/api/auth/device/code \
  -H "Authorization: Bearer $TRICKEST_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ }'

Responses

200Device authorization started
device_codestringrequired
user_codestringrequired
verification_uristringrequired
verification_uri_completestringrequired
expires_inintegerrequired
intervalintegerrequired
400Bad Request – validation error or malformed input
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

500Internal Server Error
codestringrequired
messagestringrequired
detailsobject

Field-level detail when the error is a validation failure.

PreviousAuthRefresh the session tokensAuthNextPoll or redeem CLI device authorization