Manajemen

Perbarui API Key

Perbarui API key di Workspace 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 pengguna yang sudah ada.

Body Permintaan

Setidaknya satu field harus diberikan.

FieldTipeDefault / 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 tempat desimal.
limitCurrencyenumdefault USDHanya USD. Mengirimkan CNY akan mengembalikan 400 currency_retired. Jika diatur, limitAmount wajib diisi.
modelsstring[]-Allowlist model yang diperbarui
deliveryPolicystring | nullauto, verified, official, nullnull mewarisi delivery policy Workspace.
expiresAtstring | nulldatetime RFC3339null menghapus masa berlaku

Catatan

  • Field moneter hanya dalam USD. Input CNY sudah dihentikan dan mengembalikan 400 currency_retired.

  • Management API tidak menyediakan penghapusan. Gunakan inactive untuk penangguhan sementara dan revoked untuk menonaktifkan key secara permanen.

  • Ganti key yang dicabut dengan key baru. Mengatur key yang telah dicabut ke active akan mengembalikan 409 api_key_revoked.

  • suspended dapat muncul dalam respons, tetapi Anda tidak dapat mengirimkannya.

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

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.

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

idstring
Pengidentifikasi API key yang digunakan dalam panggilan Management API berikutnya.
namestring
Nama tampilan untuk API key.
key_prefixstring
Awalan key non-rahasia untuk tampilan dan dukungan teknis.
statusstring
Salah satu dari active, inactive, suspended, atau revoked.
limit_amountnumber | null
Batas pengeluaran dalam USD sebagai angka JSON untuk tampilan. null berarti tanpa batas.
limit_amount_decimalstring | null
Batas pengeluaran tepat dalam USD sebagai string desimal. null berarti tanpa batas.
used_amountnumber
Akumulasi penggunaan dalam USD sebagai angka JSON untuk tampilan.
used_amount_decimalstring
Akumulasi penggunaan tepat dalam USD sebagai string desimal.
modelsstring[]
Allowlist model per key. Array kosong berarti tidak ada pembatasan model tingkat key tambahan.
delivery_policystring | null
auto, verified, official, null. null mewarisi delivery policy Workspace.
expires_atstring | null
Timestamp ISO saat key kedaluwarsa, atau null jika tanpa masa kedaluwarsa.
last_used_atstring | null
Timestamp ISO untuk penggunaan terakhir, atau null jika belum pernah digunakan.
created_atstring
Timestamp 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