Manajemen

Perbarui API Key

Memperbarui API key user yang ada untuk organisasi saat ini.

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

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.

BidangTipeDefault / BatasCatatan
statusenum-active, inactive, revoked
namestringpanjang 1-50Nama tampilan yang diperbarui
limitAmountnumber | string | null0–100000 USDnull berarti tanpa batas; 0 mencegah pengeluaran. String desimal mendukung hingga 6 angka desimal.
limitCurrencyenumbawaan USDHanya USD. Mengirim CNY menghasilkan 400 currency_retired. Jika diisi, limitAmount juga wajib disertakan.
modelsstring[]-Daftar izin model yang diperbarui
deliveryPolicystring | nullauto, verified, official, nullnull mewarisi kebijakan pengiriman ruang kerja.
expiresAtstring | nulldatetime RFC3339null menghapus masa kedaluwarsa

Catatan

  • Kolom moneter hanya mendukung USD. Input CNY telah dihentikan dan mengembalikan 400 currency_retired.

  • Hard delete memang tidak didukung di Management API v1.

  • revoked bersifat terminal untuk penggunaan operasional biasa; buat key baru daripada mengharapkan alur un-revoke di masa depan.

Contoh

Permintaan

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
  }'

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.

Contoh respons

Respons

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-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

idstring
Pengidentifikasi kunci API yang digunakan dalam panggilan API Manajemen berikutnya.
namestring
Nama tampilan kunci API.
key_prefixstring
Awalan kunci nonrahasia untuk tampilan dan dukungan.
statusstring
Salah satu dari active, inactive, suspended, atau revoked.
limit_amountnumber | null
Batas pengeluaran USD sebagai angka JSON untuk tampilan. null berarti tanpa batas.
limit_amount_decimalstring | null
Batas pengeluaran USD yang tepat sebagai string desimal. null berarti tanpa batas.
used_amountnumber
Akumulasi biaya penggunaan dalam USD sebagai angka JSON untuk tampilan.
used_amount_decimalstring
Akumulasi biaya penggunaan yang tepat dalam USD sebagai string desimal.
modelsstring[]
Daftar model yang diizinkan per kunci. Array kosong berarti tidak ada batasan model tambahan di tingkat kunci.
delivery_policystring | null
auto, verified, official, null. null mewarisi kebijakan pengiriman ruang kerja.
expires_atstring | null
Stempel waktu ISO saat kunci kedaluwarsa, atau null jika tidak kedaluwarsa.
last_used_atstring | null
Stempel waktu ISO penggunaan terbaru, atau null jika belum pernah digunakan.
created_atstring
Stempel waktu ISO pembuatan.

Otorisasi

ManagementTokenAuth
AuthorizationBearer <token>

Autentikasi token manajemen. Buat atau kelola Management Token di Dashboard > API > Management Tokens.

Lokasi: header

Parameter path

keyId*string

Body permintaan

application/json

Setidaknya satu bidang harus disediakan.

Properti1 <= properties

Respons

application/json

application/json

application/json

application/json

application/json

application/json