API キーの更新

PUT /api/v1/gateway/keys/{key_id}

キーの名称、モデル許可リスト、レート制限、消費上限を更新します。変更したいフィールドだけを送信してください。管理者以上のロール（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

リクエストボディ

フィールド	型	必須	説明
`name`	string \| null	いいえ	キー名
`models_allowed`	array \| null	いいえ	利用可能モデルの許可リスト
`allowed_ips`	array \| null	いいえ	IP 許可リスト
`rpm_limit`	integer \| null	いいえ	毎分リクエスト数の上限
`tpm_limit`	integer \| null	いいえ	毎分トークン数の上限
`spending_limit_usd`	number \| string \| null	いいえ	累計消費上限（USD）

リクエスト例

curl -X PUT https://portal.aiin1.ai/api/v1/gateway/keys/KEY_ID \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "rpm_limit": 600 }'

レスポンス

フィールド	型	必須	説明
`id`	string(uuid)	はい	キー ID
`org_id`	string(uuid)	はい	組織 ID
`team_id`	string \| null	いいえ	所属チーム ID
`name`	string	はい	キー名
`key`	string \| null	いいえ	完全なキー。作成 / ローテーション時に一度だけ返却
`key_prefix`	string	はい	キーのプレフィックス（表示用）
`models_allowed`	array<string>	はい	利用可能モデルの許可リスト（空配列 = 制限なし）
`rpm_limit`	integer	はい	毎分リクエスト数の上限
`tpm_limit`	integer	はい	毎分トークン数の上限
`is_sandbox`	boolean	はい	サンドボックスキーかどうか
`allowed_ips`	array \| null	いいえ	IP 許可リスト（null = 制限なし）
`spending_limit_usd`	string \| null	いいえ	累計消費上限（USD）。null = 無制限
`expires_at`	string \| null	いいえ	有効期限
`rotate_grace_until`	string \| null	いいえ	ローテーション後の旧キーの猶予期限
`status`	string	はい	状態
`created_at`	string(datetime)	はい	作成日時