구성 리비전 목록 조회

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