Elenca i token della directory

GET /v1/directories/{directory_id}/tokens · autorizzazione directories:write

Elenca i metadati dei token SCIM della directory, dal più recente, inclusi quelli revocati e scaduti; mai il token né il suo digest. Esiste solo la paginazione in avanti; il cursore è vincolato alla directory. Elencare i token richiede directories:write.

Richiesta

Campo Tipo Obbligatorio Descrizione
directory_id path sì ID della directory SCIM (dir_…).
limit query no 1–100, predefinito 20.
after query no Il cursore di list_metadata.after.

Non c'è un corpo della richiesta.

Risposta

200 OK con una pagina di metadati dei token.

{
  "data": [
    {
      "id": "0192a3b5-0a1b-7c2d-8e3f-4a5b6c7d8e9f",
      "label": "rotation",
      "created_at": "2026-10-19T09:40:00.123456Z",
      "expires_at": "2027-01-17T09:40:00.123456Z",
      "revoked_at": null,
      "last_used_at": null
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Errori

HTTP code Quando
400 invalid_cursor Il cursore non è valido o appartiene a un'altra directory o filtro.
404 not_found La directory non esiste in questo ambiente.
422 validation_failed limit è fuori intervallo, oppure è stato fornito before o order (unsupported).
401 unauthenticated La credenziale è mancante, non valida o revocata.
403 insufficient_permissions La credenziale non ha l'autorizzazione richiesta.
429 rate_limited È stato superato il limite di frequenza; riprova dopo il periodo Retry-After.
503 service_unavailable La sincronizzazione delle directory è temporaneamente non disponibile o non configurata in questa installazione; riprova dopo il periodo Retry-After.

Esempio

curl -i "https://api.eu.keenauth.com/v1/directories/dir_01j9xm2n4p6q8r0s2t4v6w8y0z/tokens" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"