Admiral
Clusters

List cluster tokens

GET
/api/v1/clusters/{cluster_id}/tokens

Scope: cluster:read

Authorization

bearerAuth
AuthorizationBearer <token>

Personal Access Token (PAT) or Service Access Token (SAT). Pass the token in the Authorization header: Bearer adm_pat_...

In: header

Path Parameters

cluster_id*cluster_id

The cluster to list tokens for (UUID).

Formatuuid

Query Parameters

filter?filter

Filter expression to narrow results. Uses the Admiral filter DSL.

Filterable fields:

  • name -- filter by token name.
  • status -- filter by token status (ACTIVE, REVOKED).

Example: field['status'] = 'ACTIVE'

Lengthlength <= 1024
page_size?page_size

Maximum number of tokens to return per page.

Formatint32
Range0 <= value <= 100
page_token?page_token

Opaque pagination token from a previous response.

Response Body

application/json

curl -X GET "https://admiral.example.com/api/v1/clusters/497f6eca-6276-4993-bfeb-53cbbbba6f08/tokens"
{  "access_tokens": [    {      "id": "9f8e7d6c-5b4a-3210-fedc-ba0987654321",      "name": "ci-deploy-key",      "token_type": "TOKEN_TYPE_PAT",      "scopes": [        "deploy:write",        "app:read",        "env:read"      ],      "status": "ACCESS_TOKEN_STATUS_ACTIVE",      "binding_type": "BINDING_TYPE_USER",      "binding_id": "d290f1ee-6c54-4b01-90e6-d701748f0851",      "created_by": "d290f1ee-6c54-4b01-90e6-d701748f0851",      "expires_at": "2026-06-01T00:00:00Z",      "last_used_at": "2025-11-20T14:30:00Z",      "created_at": "2025-09-01T10:00:00Z"    }  ],  "next_page_token": "string"}