Manajemen
Perbarui API Key
Perbarui API key di Workspace saat ini.
Ikhtisar
Gunakan endpoint ini untuk memperbarui nama, batas penggunaan, model yang diizinkan, masa berlaku, atau status API key pengguna yang sudah ada.
Body Permintaan
Setidaknya satu field harus diberikan.
| Field | Tipe | Default / Batas | Catatan |
|---|---|---|---|
status | enum | - | active, inactive, revoked |
name | string | panjang 1-50 | Nama tampilan yang diperbarui |
limitAmount | number | string | null | 0–100000 USD | null berarti tanpa batas; 0 mencegah pengeluaran. String desimal mendukung hingga 6 tempat desimal. |
limitCurrency | enum | default USD | Hanya USD. Mengirimkan CNY akan mengembalikan 400 currency_retired. Jika diatur, limitAmount wajib diisi. |
models | string[] | - | Allowlist model yang diperbarui |
deliveryPolicy | string | null | auto, verified, official, null | null mewarisi delivery policy Workspace. |
expiresAt | string | null | datetime RFC3339 | null menghapus masa berlaku |
Catatan
-
Field moneter hanya dalam USD. Input
CNYsudah dihentikan dan mengembalikan400 currency_retired. -
Management API tidak menyediakan penghapusan. Gunakan
inactiveuntuk penangguhan sementara danrevokeduntuk menonaktifkan key secara permanen. -
Ganti key yang dicabut dengan key baru. Mengatur key yang telah dicabut ke
activeakan mengembalikan409 api_key_revoked. -
suspendeddapat muncul dalam respons, tetapi Anda tidak dapat mengirimkannya.
Permintaan
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
}'Permintaan / Respons
Halaman ini menyediakan skema OpenAPI dan contoh request yang dapat disalin. Kirim request manajemen dari terminal atau klien Anda dengan Management Token; pengiriman langsung tidak tersedia di halaman ini.
Respons
{
"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
}Field penting
active, inactive, suspended, atau revoked.null berarti tanpa batas.null berarti tanpa batas.auto, verified, official, null. null mewarisi delivery policy Workspace.null jika tanpa masa kedaluwarsa.null jika belum pernah digunakan.Otorisasi
ManagementTokenAuth Autentikasi token manajemen. Buat atau kelola Management Token di Dashboard > API > Management Tokens.
Lokasi: header
Parameter path
Body permintaan
application/json
Setidaknya satu bidang harus disediakan.
1 <= propertiesRespons
application/json
application/json
application/json
application/json
application/json
application/json