A pending `bl login`

GET

/api/v1/cli/requests/{code}

curl --request GET \
  --url https://example.com/api/v1/cli/requests/example \
  --cookie bl_%3Cslug%3E_session=%3Cbl_%3Cslug%3E_session%3E

Which machine and which version of bl ask for access with this user code, and until when. The approval page shows it before the user logs in at /auth/login?device=<code> to approve, or denies. Only for a person logged in through the identity provider, not for an API key; at most 20 codes a minute.

Authorizations

• session
• dpop
• bearer

Parameters

Path Parameters

code

required

string

The user code that bl login shows.

Responses

200

OK.

Media typeapplication/json

object

user_code

required

string

device_name

required

string

client_version

required

string

created_at

required

string format: date-time

expires_at

required

string format: date-time

Example ^generated

{
  "user_code": "example",
  "device_name": "example",
  "client_version": "example",
  "created_at": "2026-04-15T12:00:00Z",
  "expires_at": "2026-04-15T12:00:00Z"
}

403

Not a person logged in through the identity provider.

Media typeapplication/json

The body of every failed call to a management API.

object

error

required

object

code

required

Stable, machine-readable: invalid_request, unauthenticated, forbidden, not_found, conflict, upstream_unavailable, unavailable, internal, or a more specific code of the operation.

string

message

required

For people; may change between versions.

string

Example

{
  "error": {
    "code": "not_found",
    "message": "unknown negotiation"
  }
}

404

No request with this code; it may have expired.

Media typeapplication/json

The body of every failed call to a management API.

object

error

required

object

code

required

Stable, machine-readable: invalid_request, unauthenticated, forbidden, not_found, conflict, upstream_unavailable, unavailable, internal, or a more specific code of the operation.

string

message

required

For people; may change between versions.

string

Example

{
  "error": {
    "code": "not_found",
    "message": "unknown negotiation"
  }
}