構成リビジョンの一覧

GET /v1/config-revisions · 権限 config:read

成功したプランの適用ごとに、リビジョンが保存されます。リビジョンとは、適用直前の、変更されたリソースの状態です。このリクエストは環境のリビジョンを新しいものから順に一覧表示します（order=asc で順序を逆にできます）。環境ごとに最新 50 件を保持し、各リビジョンは最大 90 日間保持されます。リビジョンに戻すには、そのリビジョンを復元してください。

項目にはメタデータのみが含まれます。保存されたリソース仕様は返されず、リビジョンにシークレットの値が含まれることもありません（シークレットは secret_ref のプレースホルダーとしてのみ現れます）。

リクエスト

パラメータ 場所 説明
limit query ページサイズ（1–100）。
after query 次のページのカーソル（list_metadata.after）。
before query 前のページのカーソル（list_metadata.before）。
order query desc（既定値、新しいものから）または asc。

レスポンス

200 OK。Cache-Control: no-store 付き。

フィールド 説明
id リビジョンの ID（cfgr_…）。
plan_id リビジョンを保存したプランの適用元。プランが削除されると null になります（期限切れから 7 日後）。
created_by プランを適用した認証情報。
created_at プランが適用された日時。
kinds プランが対象とした種類。
summary 適用時の create、update、delete、no_op の件数。 
{
  "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}
}

エラー

HTTP code 発生条件
400 invalid_cursor カーソルの形式が不正か、別のリクエストのものです。
401 unauthenticated 認証情報がない、無効、または失効しています。
403 insufficient_permissions 認証情報に config:read がありません。
422 validation_failed クエリパラメータが無効です（例: limit が 1–100 の範囲外）。
429 rate_limited レート制限を超えました。Retry-After の時間が経過してから再試行してください。

例

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

keenauth config revisions list --limit 20