Lister les révisions de configuration

GET /v1/config-revisions · permission config:read

Chaque application de plan réussie enregistre une révision : l'état des ressources qu'elle a modifiées, tel qu'il était juste avant l'application. Cette requête liste les révisions de l'environnement, les plus récentes en premier (order=asc inverse l'ordre). Un environnement conserve ses 50 révisions les plus récentes, chacune pendant 90 jours au plus. Pour revenir à une révision, restaurez-la.

Les éléments ne contiennent que des métadonnées. Les spécifications de ressources enregistrées ne sont pas renvoyées, et les révisions ne contiennent jamais de valeurs secrètes (les secrets n'apparaissent que sous forme de marqueurs secret_ref).

Requête

Paramètre Dans Description
limit query Taille de page, 1–100.
after query Curseur de la page suivante (list_metadata.after).
before query Curseur de la page précédente (list_metadata.before).
order query desc (par défaut, les plus récentes en premier) ou asc.

Réponse

200 OK avec Cache-Control: no-store.

Champ Description
id L'identifiant de la révision, cfgr_….
plan_id Le plan dont l'application a enregistré la révision ; null une fois le plan supprimé (7 jours après son expiration).
created_by L'identifiant qui a appliqué le plan.
created_at Moment où le plan a été appliqué.
kinds Les types couverts par le plan.
summary Les nombres create, update, delete et no_op de l'application. 
{
  "data": [
    {
      "id": "cfgr_01m4qpqtywfs7930tb6kqn5rc5",
      "plan_id": "cfgp_01m4qpqtywfs7930tb6kqn5rc5",
      "created_by": "key_01m4qpqtywfs7930tb6kqn5rc5",
      "created_at": "2026-10-19T10:00:00Z",
      "kinds": ["connection"],
      "summary": {"create": 1, "update": 1, "delete": 0, "no_op": 1}
    }
  ],
  "list_metadata": {"before": null, "after": null}
}

Erreurs

HTTP code Quand
400 invalid_cursor Le curseur est mal formé ou appartient à une autre requête.
401 unauthenticated L'identifiant est absent, invalide ou révoqué.
403 insufficient_permissions L'identifiant n'a pas config:read.
422 validation_failed Un paramètre de requête est invalide (par exemple limit hors de 1–100).
429 rate_limited La limite de débit a été dépassée ; réessayez après la durée indiquée par Retry-After.

Exemple

curl "https://api.eu.keenauth.com/v1/config-revisions?limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"

keenauth config revisions list --limit 20