TokenLab

管理

更新 API Key

更新當前 Workspace 中的 API key。

PATCHhttps://api.tokenlab.sh/v1/management/api-keys/{keyId}

概覽

使用此端點更新現有使用者 API key 的名稱、用量限額、允許的模型、到期時間或狀態。

請求主體

必須提供至少一個欄位。

欄位類型預設值 / 限制說明
statusenum-active、inactive、revoked
namestring長度 1-50更新後的顯示名稱
limitAmountnumber | string | null0–100000 USDnull 表示無限制;0 表示禁止支出。十進位字串最多支援 6 位小數。
limitCurrencyenum預設為 USD僅限 USD。傳送 CNY 將回傳 400 currency_retired。設定此項時,必須提供 limitAmount。
modelsstring[]-更新後的模型允許清單
deliveryPolicystring | nullauto、verified、official、nullnull 會繼承 Workspace 的交付策略。
expiresAtstring | nullRFC3339 日期時間null 會清除到期時間

注意事項

  • 金額欄位僅支援 USD。CNY 輸入已廢棄,將回傳 400 currency_retired。

  • Management API 不提供刪除功能。使用 inactive 進行暫時停用,使用 revoked 永久停用 key。

  • 已廢止的 key 需以新 key 取代。將已廢止的 key 設為 active 將回傳 409 api_key_revoked。

  • suspended 可能會出現在回應中,但您無法傳送此值。

範例

請求

cURL
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 從您的終端機或客戶端發送管理請求;此頁面不支援直接發送。

回應範例

回應

200 OK
{
  "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
}

重要欄位

idstring
後續 Management API 呼叫所使用的 API key 識別碼。
namestring
API key 的顯示名稱。
key_prefixstring
用於顯示和支援的非機密 key 前綴。
statusstring
為 active、inactive、suspended 或 revoked 之一。
limit_amountnumber | null
以 JSON 數字顯示的 USD 支出上限。null 表示無限制。
limit_amount_decimalstring | null
以十進位字串表示的精準 USD 支出上限。null 表示無限制。
used_amountnumber
以 JSON 數字顯示的累計 USD 用量。
used_amount_decimalstring
以十進位字串表示的精準累計 USD 用量。
modelsstring[]
個別 key 的模型允許清單。空陣列表示沒有額外的 key 層級模型限制。
delivery_policystring | null
auto、verified、official、null。null 會繼承 Workspace 的交付策略。
expires_atstring | null
Key 到期的 ISO 時間戳記,若無到期時間則為 null。
last_used_atstring | null
最近一次使用的 ISO 時間戳記,若未使用過則為 null。
created_atstring
ISO 建立時間戳記。

授權

ManagementTokenAuth
AuthorizationBearer <token>

管理權杖驗證。請在 Dashboard > API > Management Tokens 建立或管理管理權杖。

位置: header

路徑參數

keyId*string

請求主體

application/json

必須提供至少一個欄位。

屬性1 <= properties

回應

application/json

application/json

application/json

application/json

application/json

application/json