API キーのローテーション
PUT /api/v1/gateway/keys/{key_id}/rotate
既存のキーを置き換える新しいキーを発行します。旧キーは猶予期間の終了まで使用でき、スムーズな切り替えが可能です。完全な新キーはこのレスポンスで一度だけ返されます。管理者以上のロール（admin / ops / super）が必要です。
認証：本エンドポイントはコンソールバックエンド API（Base URL
https://portal.aiin1.ai、api.portal.aiin1.aiではありません）に属します。コンソールアカウントでログインして取得したaccess_token（15 分間有効）が必要で、sk-nex-API トークンは使用できません。ログイン方法は 請求照合と使用量自動同期 を参照してください。
リクエストパラメータ
| パラメータ | 位置 | 型 | 必須 | 説明 |
|---|---|---|---|---|
key_id |
path | string(uuid) | はい | キー ID |
リクエスト例
curl -X PUT https://portal.aiin1.ai/api/v1/gateway/keys/KEY_ID/rotate \
-H "Authorization: Bearer $ACCESS_TOKEN"レスポンス
| フィールド | 型 | 必須 | 説明 |
|---|---|---|---|
new_key_id |
string(uuid) | はい | 新キー ID |
new_key |
string | null | いいえ | 完全な新キー。一度だけ表示 |
new_key_prefix |
string | はい | 新キーのプレフィックス |
old_key_id |
string(uuid) | はい | 旧キー ID |
old_key_grace_until |
string(datetime) | はい | 旧キーの失効時刻（猶予期限） |
message |
string | いいえ | メッセージ |