Skip to navigation

Poll CLI Authorization

View as Markdown
Returns whether the request is still pending or has finished, or, once it is approved, the encrypted API key, which can be delivered only once.

Path parameters

cliAuthorizationIdstringRequiredformat: "uuid"
Public CLI authorization request identifier

Headers

X-Cli-Poll-SecretstringRequired

One-time poll credential returned by request creation

Response headers

X-RateLimit-LimitintegerOptional

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-RemainingintegerOptional

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-ResetintegerOptional

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

Authorization is still pending or issuing
expiresAtdatetime
Authorization request expiry timestamp
statusenum
Current broker lifecycle state
deliveryobject or nullOptional

Encrypted one-time delivery, present only for KEY_READY

terminalReasonenum or nullOptional

Why the request ended (contains no secrets)

Errors

400
Bad Request Error
404
Not Found Error
406
Not Acceptable Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error