管理
APIキーの更新
現在のWorkspace内のAPIキーを更新します。
概要
既存のユーザーAPIキーの名前、使用制限額、許可モデル、有効期限、またはステータスを更新するには、このエンドポイントを使用します。
リクエストボディ
少なくとも1つのフィールドを指定する必要があります。
| フィールド | タイプ | デフォルト / 制限 | 説明 |
|---|---|---|---|
status | enum | - | active、inactive、revoked |
name | string | 長さ 1-50 | 更新後の表示名 |
limitAmount | number | string | null | 0–100000 USD | null は無制限を意味し、0 は支出を停止します。小数文字列は最大6桁の小数をサポートします。 |
limitCurrency | enum | デフォルト USD | USDのみ。CNY を送信すると 400 currency_retired が返されます。設定する場合、limitAmount が必須です。 |
models | string[] | - | 更新後のモデル許可リスト |
deliveryPolicy | string | null | auto、verified、official、null | null はWorkspaceの配信ポリシーを継承します。 |
expiresAt | string | null | RFC3339 datetime | null は有効期限をクリアします |
注意事項
-
金額フィールドはUSDのみです。
CNYの入力は廃止されており、400 currency_retiredが返されます。 -
Management API には削除機能がありません。一時的な停止には
inactiveを、キーを完全に廃止するにはrevokedを使用してください。 -
取り消されたキーは新しいキーに置き換えてください。取り消されたキーを
activeに設定すると409 api_key_revokedが返されます。 -
suspendedはレスポンスに表示される場合がありますが、リクエストで送信することはできません。
リクエスト
curl -X PATCH "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456" \
-H "Authorization: Bearer mt-your-management-token" \
-H "Content-Type: application/json" \
-d '{
"status": "inactive",
"limitAmount": 0
}'リクエスト / レスポンス
このページでは、OpenAPIスキーマとコピー可能なリクエスト例を提供しています。Management Token を使用してターミナルまたはクライアントから管理リクエストを送信してください。このページから直接送信することはできません。
レスポンス
{
"id": "key_abc123def456",
"name": "Backend Worker",
"key_prefix": "sk-live...",
"status": "inactive",
"limit_amount": 0,
"limit_amount_decimal": "0",
"used_amount": 148.25,
"used_amount_decimal": "148.25",
"models": [
"gpt-5.6-luna",
"claude-sonnet-4-6"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": "2026-07-08T03:12:45.000Z",
"created_at": "2026-07-01T10:00:00.000Z",
"delivery_policy": null
}重要なフィールド
active、inactive、suspended、revoked のいずれか。null は無制限を意味します。null は無制限を意味します。auto、verified、official、null。null はWorkspaceの配信ポリシーを継承します。null。null。認証
ManagementTokenAuth 管理トークン認証。Dashboard > API > Management Tokensで管理トークンを作成または管理します。
場所: header
パスパラメータ
リクエストボディ
application/json
少なくとも1つのフィールドを指定する必要があります。
1 <= propertiesレスポンス
application/json
application/json
application/json
application/json
application/json
application/json