ブランディングバージョンを一覧表示

GET /v1/branding/versions · 権限 branding:read

公開済みバージョンを新しい順に、カーソルページネーション (limit、after) で一覧表示します。前方へのページングのみ対応し、before と order は 422 で拒否されます。総数は返されません。

リクエスト

フィールド タイプ 必須 説明
limit クエリ いいえ 1 ページあたり 1-100 件。
after クエリ いいえ list_metadata.after のカーソル。

レスポンス

200 OK と data[] (バージョンのメタデータ) および list_metadata。

{"data": [{"version": 4, "snapshot_sha256": "3f1c…", "source": "publish", "rolled_back_from": null,
           "actor_type": "api_key", "actor_id": "key_01jb…", "published_at": "2026-10-05T09:31:00Z"}],
 "list_metadata": {"before": null, "after": "eyJ2Ijo…"}}

エラー

HTTP コード 概要
400 invalid_cursor カーソルの形式が不正か、別の環境のものです。
422 validation_failed limit が範囲外か、before/order が指定されました (unsupported)。
401 unauthenticated 認証情報がない、無効、または失効しています。
403 insufficient_permissions 認証情報に必要な権限がありません。
429 rate_limited レート制限を超えました。Retry-After の期間後に再試行してください。
503 service_unavailable 依存サービスが一時的に利用できません。Retry-After の期間後に再試行してください。

例

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