Quản lý
Cập nhật API Key
Cập nhật API key trong Workspace hiện tại.
Tổng quan
Sử dụng endpoint này để cập nhật tên, giới hạn sử dụng, các model được phép, thời hạn hết hạn hoặc trạng thái của một user API key hiện có.
Phần thân yêu cầu (Request Body)
Phải cung cấp ít nhất một trường.
| Trường | Kiểu dữ liệu | Mặc định / Giới hạn | Ghi chú |
|---|---|---|---|
status | enum | - | active, inactive, revoked |
name | string | độ dài 1-50 | Tên hiển thị được cập nhật |
limitAmount | number | string | null | 0–100000 USD | null nghĩa là không giới hạn; 0 ngăn chặn chi tiêu. Chuỗi số thập phân hỗ trợ tối đa 6 chữ số thập phân. |
limitCurrency | enum | mặc định USD | Chỉ hỗ trợ USD. Gửi CNY sẽ trả về 400 currency_retired. Khi được thiết lập, bắt buộc phải có limitAmount. |
models | string[] | - | Danh sách cho phép (allowlist) model được cập nhật |
deliveryPolicy | string | null | auto, verified, official, null | null kế thừa delivery policy của Workspace. |
expiresAt | string | null | thời gian theo chuẩn RFC3339 | null sẽ xóa thời hạn hết hạn |
Lưu ý
-
Các trường tiền tệ chỉ hỗ trợ USD. Giá trị đầu vào
CNYđã ngừng hoạt động và sẽ trả về400 currency_retired. -
Management API không cung cấp tính năng xóa. Sử dụng
inactiveđể tạm dừng tạm thời vàrevokedđể hủy bỏ vĩnh viễn một key. -
Hãy thay thế key đã bị thu hồi bằng một key mới. Việc thiết lập một key đã thu hồi thành
activesẽ trả về409 api_key_revoked. -
suspendedcó thể xuất hiện trong phản hồi, nhưng bạn không thể gửi giá trị này.
Yêu cầu
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
}'Yêu cầu / Phản hồi
Trang này cung cấp lược đồ OpenAPI và các ví dụ request có thể sao chép. Gửi các request quản lý từ terminal hoặc client của bạn bằng Management Token; tính năng gửi trực tiếp không khả dụng trên trang này.
Phản hồi
{
"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
}Các trường quan trọng
active, inactive, suspended, hoặc revoked.null nghĩa là không giới hạn.null nghĩa là không giới hạn.auto, verified, official, null. null kế thừa delivery policy của Workspace.null nếu không có thời hạn.null khi chưa từng được sử dụng.Xác thực
ManagementTokenAuth Xác thực bằng Token quản lý. Tạo hoặc quản lý Token quản lý trong Dashboard > API > Management Tokens.
Vị trí: header
Tham số đường dẫn
Nội dung yêu cầu
application/json
Phải cung cấp ít nhất một trường.
1 <= propertiesPhản hồi
application/json
application/json
application/json
application/json
application/json
application/json