Listar revisiones de configuración

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

Cada aplicación de un plan correcta guarda una revisión: el estado de los recursos que cambió, tal como estaba justo antes de la aplicación. Esta solicitud lista las revisiones del entorno, de la más reciente a la más antigua (order=asc invierte el orden). Un entorno conserva sus 50 revisiones más recientes, cada una durante 90 días como máximo. Para volver a una revisión, restáurala.

Los elementos solo contienen metadatos. No se devuelven las especificaciones de recursos guardadas, y las revisiones nunca contienen valores secretos (los secretos aparecen solo como marcadores secret_ref).

Solicitud

Parámetro En Descripción
limit query Tamaño de página, 1–100.
after query Cursor de la página siguiente (list_metadata.after).
before query Cursor de la página anterior (list_metadata.before).
order query desc (predeterminado, la más reciente primero) o asc.

Respuesta

200 OK con Cache-Control: no-store.

Campo Descripción
id El id de la revisión, cfgr_….
plan_id El plan cuya aplicación guardó la revisión; null una vez eliminado el plan (7 días después de su caducidad).
created_by La credencial que aplicó el plan.
created_at Cuándo se aplicó el plan.
kinds Los tipos que cubrió el plan.
summary Los recuentos create, update, delete y no_op de la aplicación. 
{
  "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}
}

Errores

HTTP code Cuándo
400 invalid_cursor El cursor está mal formado o pertenece a otra solicitud.
401 unauthenticated La credencial falta, no es válida o está revocada.
403 insufficient_permissions La credencial no tiene config:read.
422 validation_failed Un parámetro de consulta no es válido (por ejemplo, limit fuera de 1–100).
429 rate_limited Se superó el límite de frecuencia; reintenta después del periodo de Retry-After.

Ejemplo

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

keenauth config revisions list --limit 20