v171

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0726249111.7 MB
Management keys

List management keys

Returns management keys in the current workspace, ordered by creation time with the newest key first. The api_key and token_hash fields are never returned by this endpoint; only token_prefix is included.

get/v2/management-keys

Query parameters

limitinteger

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

starting_afterstring

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

ending_beforestring

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

status'MANAGEMENT_KEY_STATUS_UNSPECIFIED' | 'MANAGEMENT_KEY_STATUS_ACTIVE' | 'MANAGEMENT_KEY_STATUS_DISABLED' | 'MANAGEMENT_KEY_STATUS_REVOKED'

Optional filter: only return keys with this status.

searchstring

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

permission_modeManagementPermissionMode[]

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

Response

OK

objectstring required

Object discriminator for list responses; always list.

has_moreboolean required

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