API referenceCLI sign-in
Check a CLI sign-in
POST
Polls a CLI sign-in with its device code. Approved returns the API key once (status used afterwards); send it as Authorization: Bearer .
Needs no sign-in. Not available to MCP clients or the assistant.
application/json- body
deviceCode*stringLength
20 <= length <= 200Success.
application/json- response
status*string|string|string|string|stringkey?intervalSeconds*integerRange
1 <= valuecurl -X POST 'https://example.com/api/v1/cliLogin.poll' \ -H 'Content-Type: application/json' \ -d '{ "deviceCode": "stringstringstringst"}'Example Response
{ "status": "pending", "key": { "id": "string", "token": "string", "name": "string", "expiresAt": "2019-08-24T14:15:22Z", "email": "string" }, "intervalSeconds": 1}Show a CLI sign-in request GET
Returns a pending CLI sign-in by its user code so the approval page can show the computer and when it expires. Any signed-in caller. Not available to MCP clients or the assistant.
Start a CLI sign-in POST
Starts a browser-approved sign-in for the laptop CLI. Show userCode, open verificationUrl, then call cliLogin.poll with deviceCode every intervalSeconds until it is no longer pending. Needs no sign-in. Not available to MCP clients or the assistant.