ブランディングをロールバック
POST /v1/branding:rollback · 権限 branding:write
以前のバージョンを再公開します。そのスナップショットが source: rollback と rolled_back_from を持つ新しいバージョンになります。下書きは変更されません。復元できるのは直近 50 バージョンのみです。
リクエスト
| フィールド | タイプ | 必須 | 説明 |
|---|---|---|---|
version |
整数 | はい | 再公開するバージョン番号 (1 以上)。 |
レスポンス
200 OK と新しいバージョンのメタデータ (スナップショット自体は返されません)。
{
"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"
}
エラー
| HTTP | コード | 概要 |
|---|---|---|
| 400 | unknown_field |
本文に不明なフィールドがあるか、JSON オブジェクトではありません。 |
| 404 | not_found |
バージョンが存在しないか、保持されていません。 |
| 422 | validation_failed |
version がない (required) か、1 未満です (out_of_range)。 |
| 401 | unauthenticated |
認証情報がない、無効、または失効しています。 |
| 403 | insufficient_permissions |
認証情報に必要な権限がありません。 |
| 429 | rate_limited |
レート制限を超えました。Retry-After の期間後に再試行してください。 |
| 503 | service_unavailable |
依存サービスが一時的に利用できません。Retry-After の期間後に再試行してください。 |
例
curl -X POST https://api.eu.keenauth.com/v1/branding:rollback \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H "Content-Type: application/json" \
-d '{"version":3}'