Skip to content

List the machines authorized through CLI browser login

GET
/v1/cli/devices
curl --request GET \
--url https://api.aetherpush.com/v1/cli/devices \
--header 'Authorization: Bearer <token>'

Session-only. Lists credentials whose origin is cli_browser or cli_device. Dashboard sessions and manually created access keys are managed under /v1/access-keys instead.

Authorized devices.

Media typeapplication/json
object
devices
required
Array<object>
object
credentialId
required
string format: uuid
deviceName
string | null
clientName
string | null
clientVersion
string | null
clientPlatform
string | null
credentialOrigin
string
Allowed values: cli_browser cli_device
createdTime
required
integer format: int64
expires
required
integer format: int64
current
required

True for the credential the request itself is authenticated with.

boolean
Example
{
"devices": [
{
"credentialOrigin": "cli_browser"
}
]
}

The bearer token is missing, invalid, or expired.

Media typeapplication/json
object
error
required

Human-readable error message.

string
requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string
Example
{
"error": "The requested resource was not found.",
"requestId": "req_abc123"
}

API keys and named access keys cannot access this endpoint; a login session is required.

Media typeapplication/json
object
error
required

Human-readable error message.

string
requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string
Example
{
"error": "The requested resource was not found.",
"requestId": "req_abc123"
}

Internal server error.

Media typeapplication/json
object
error
required

Human-readable error message.

string
requestId

Unique identifier for the request, also exposed as the X-Request-Id response header.

string
Example
{
"error": "The requested resource was not found.",
"requestId": "req_abc123"
}