Lister les jetons d'un annuaire

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

Liste les métadonnées des jetons SCIM de l'annuaire, du plus récent au plus ancien, révoqués et expirés inclus ; jamais le jeton ni son empreinte. Seule la pagination vers l'avant existe ; le curseur est lié à l'annuaire. Lister les jetons requiert directories:write.

Requête

Champ Type Obligatoire Description
directory_id path oui Identifiant de l'annuaire SCIM (dir_…).
limit query non 1–100, valeur par défaut 20.
after query non Le curseur issu de list_metadata.after.

Il n'y a pas de corps de requête.

Réponse

200 OK avec une page de métadonnées de jetons.

{
  "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
  }
}

Erreurs

HTTP code Quand
400 invalid_cursor Le curseur est invalide ou appartient à un autre annuaire ou filtre.
404 not_found L'annuaire n'existe pas dans cet environnement.
422 validation_failed limit est hors plage, ou before ou order a été fourni (unsupported).
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant ne dispose pas de l'autorisation requise.
429 rate_limited La limite de débit a été dépassée ; réessayez après la période Retry-After.
503 service_unavailable La synchronisation des annuaires est temporairement indisponible ou non configurée dans ce déploiement ; réessayez après la période Retry-After.

Exemple

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