Yapılandırma revizyonlarını listele

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

Her başarılı plan uygulaması bir revizyon saklar: değiştirdiği kaynakların uygulamadan hemen önceki hâli. Bu işlem ortamın revizyonlarını en yeni önce listeler (order=asc sırayı çevirir). Bir ortam en yeni 50 revizyonunu, her birini en çok 90 gün saklar. Bir revizyona dönmek için onu geri yükleyin.

Öğeler yalnız üst bilgi taşır. Saklanan kaynak spec'leri dönmez ve revizyonlar hiçbir zaman gizli değer içermez (sırlar yalnız secret_ref yer tutucusu olarak bulunur).

İstek

Parametre	Yer	Açıklama
`limit`	sorgu	Sayfa boyutu, 1–100.
`after`	sorgu	Sonraki sayfanın imleci (`list_metadata.after`).
`before`	sorgu	Önceki sayfanın imleci (`list_metadata.before`).
`order`	sorgu	`desc` (varsayılan, en yeni önce) ya da `asc`.

Yanıt

200 OK, Cache-Control: no-store ile.

Alan	Açıklama
`id`	Revizyon kimliği, `cfgr_…`.
`plan_id`	Uygulaması revizyonu saklayan plan; plan silinince (süresi dolduktan 7 gün sonra) `null`.
`created_by`	Planı uygulayan kimlik bilgisi.
`created_at`	Planın uygulandığı an.
`kinds`	Planın kapsadığı türler.
`summary`	Uygulamanın `create`, `update`, `delete` ve `no_op` sayıları.

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

Hatalar

HTTP	code	Ne zaman
400	`invalid_cursor`	İmleç bozuk ya da başka bir isteğe ait.
401	`unauthenticated`	Kimlik bilgisi eksik, geçersiz ya da iptal edilmiş.
403	`insufficient_permissions`	Kimlik bilgisinde `config:read` yok.
422	`validation_failed`	Bir sorgu parametresi geçersiz (örneğin `limit` 1–100 dışında).
429	`rate_limited`	Hız sınırı aşıldı; `Retry-After` süresinden sonra yeniden deneyin.

Örnek

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

keenauth config revisions list --limit 20