Manajemen
Perbarui API Key
Memperbarui API key user yang ada untuk organisasi saat ini.
Ikhtisar
Gunakan endpoint ini untuk memperbarui nama, batas penggunaan, model yang diizinkan, masa berlaku, atau status API key user yang ada.
Body Request
Setidaknya satu field harus disediakan.
| Bidang | 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 angka desimal. |
limitCurrency | enum | bawaan USD | Hanya USD. Mengirim CNY menghasilkan 400 currency_retired. Jika diisi, limitAmount juga wajib disertakan. |
models | string[] | - | Daftar izin model yang diperbarui |
deliveryPolicy | string | null | auto, verified, official, null | null mewarisi kebijakan pengiriman ruang kerja. |
expiresAt | string | null | datetime RFC3339 | null menghapus masa kedaluwarsa |
Catatan
-
Kolom moneter hanya mendukung USD. Input
CNYtelah dihentikan dan mengembalikan400 currency_retired. -
Hard delete memang tidak didukung di Management API v1.
-
revokedbersifat terminal untuk penggunaan operasional biasa; buat key baru daripada mengharapkan alur un-revoke di masa depan.
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
}'Request / Respons
Halaman ini menyediakan skema OpenAPI dan contoh permintaan yang dapat disalin. Kirim permintaan manajemen dari terminal atau klien menggunakan 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-3-7-sonnet"
],
"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
}Kolom penting
active, inactive, suspended, atau revoked.null berarti tanpa batas.null berarti tanpa batas.auto, verified, official, null. null mewarisi kebijakan pengiriman ruang kerja.null jika tidak 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