Skip to main content
GET
List management keys

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer<int32>

Page size, 1–200. Unset uses the server default (25).

starting_after
string

Cursor for forward pagination. Set to the management_key_id of the last item from the previous page.

ending_before
string

Cursor for backward pagination. Set to the management_key_id of the first item from the previous page.

status
enum<string>

Optional filter: only return keys with this status.

Available options:
MANAGEMENT_KEY_STATUS_UNSPECIFIED,
MANAGEMENT_KEY_STATUS_ACTIVE,
MANAGEMENT_KEY_STATUS_DISABLED,
MANAGEMENT_KEY_STATUS_REVOKED

Optional case-insensitive substring match against the management-key name. Empty means no name filter.

permission_mode
enum<string>[]

Optional filter: only return keys whose permission mode is one of the listed presets. Empty means no permission-mode filter.

Available options:
MANAGEMENT_PERMISSION_MODE_UNSPECIFIED,
MANAGEMENT_PERMISSION_MODE_ALL,
MANAGEMENT_PERMISSION_MODE_RESTRICTED,
MANAGEMENT_PERMISSION_MODE_READ_ONLY

Response

200 - application/json

OK

object
string
required

Object discriminator for list responses; always list.

data
object[]
required

Page of management-keys, ordered newest first. token_hash and api_key are always elided in list responses.

has_more
boolean
required

Whether more management-keys are available in the selected pagination direction.