Skip to main content
POST
Start the device authorization flow. The CLI or MCP server calls this endpoint to get a device code and user code. No authentication required. This is a public endpoint.

Flow

  1. Client calls this endpoint to get codes
  2. User visits the verification_uri and enters the user_code
  3. Client polls /v1/auth/device/token until user approves
User codes use the format XXXX-XXXX with an unambiguous alphabet (no 0/O, 1/I/l confusion).

Request Body

Response Fields