Skip to main content
POST
Start CLI Authorization

Headers

OpenPMM-Request-Id
string

Optional request ID. OpenPMM returns this value when it is valid. Otherwise, OpenPMM creates a request ID.

Maximum string length: 128

Body

application/json

A human-readable device name and optional CLI version.

device_name
string
required
Required string length: 1 - 200
cli_version
string
Required string length: 1 - 100

Response

The pending browser authorization.

object
string
required
Allowed value: "cli_authorization"
sensitive
boolean
required

This response contains one-time credentials.

device_secret
string
required

One-time device secret. Store it only until exchange.

verification_uri
string<uri>
required
verification_uri_complete
string<uri>
required

One-time sign-in URL. Treat this URL as sensitive.

expires_at
string<date-time>
required
Example:

"2026-08-09T12:00:00.000Z"

interval
integer
required
Required range: x >= 1
Example:

5