管理
更新 API Key
更新當前 Workspace 中的 API key。
概覽
使用此端點更新現有使用者 API key 的名稱、用量限額、允許的模型、到期時間或狀態。
請求主體
必須提供至少一個欄位。
| 欄位 | 類型 | 預設值 / 限制 | 說明 |
|---|---|---|---|
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 日期時間 | null 會清除到期時間 |
注意事項
-
金額欄位僅支援 USD。
CNY輸入已廢棄,將回傳400 currency_retired。 -
Management API 不提供刪除功能。使用
inactive進行暫時停用,使用revoked永久停用 key。 -
已廢止的 key 需以新 key 取代。將已廢止的 key 設為
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 <= properties回應
application/json
application/json
application/json
application/json
application/json
application/json