Perbarui API Key

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

{
  "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-mini",
    "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"
}

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 \| null	minimum `0`, input maksimum `1000000`	`null` = tidak terbatas, `0` = kuota nol. Nilai positif dinormalisasi menjadi batas simpan yang tidak melebihi setara `100000` USD
`limitCurrency`	enum	bawaan `USD`	Hanya USD. Mengirim `CNY` menghasilkan `400 currency_retired`.
`models`	string[]	-	Daftar izin model yang diperbarui
`expiresAt`	string \| null	datetime RFC3339	`null` 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

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

Gunakan panel OpenAPI interaktif di atas untuk skema dan field respons yang tepat.

Contoh 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-mini",
    "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"
}

Kolom penting

string

Pengidentifikasi kunci API yang digunakan dalam panggilan API Manajemen berikutnya.

string

Nama tampilan kunci API.

string

Awalan kunci nonrahasia untuk tampilan dan dukungan.

string

Salah satu dari active, inactive, atau revoked.

number | null

Batas pengeluaran USD sebagai angka JSON untuk tampilan. null berarti tanpa batas.

string | null

Batas pengeluaran USD yang tepat sebagai string desimal. null berarti tanpa batas.

number

Akumulasi biaya penggunaan dalam USD sebagai angka JSON untuk tampilan.

string

Akumulasi biaya penggunaan yang tepat dalam USD sebagai string desimal.

string[]

Daftar model yang diizinkan per kunci. Array kosong berarti tidak ada batasan model tambahan di tingkat kunci.

string | null

Stempel waktu ISO saat kunci kedaluwarsa, atau null jika tidak kedaluwarsa.

string | null

Stempel waktu ISO penggunaan terbaru, atau null jika belum pernah digunakan.

string

Stempel waktu ISO pembuatan.

Inti

Teks

Berkas & batch

Gambar

Audio & realtime

Musik

Video & materi

Worlds

3D

Pekerjaan asinkron

Gemini native

Manajemen

Ikhtisar

Body Request

Catatan

Contoh

Request / Respons

Contoh respons

Kolom penting

​Ikhtisar

​Body Request

​Catatan

​Contoh

​Request / Respons

​Contoh respons

​Kolom penting

Ikhtisar

Body Request

Catatan

Contoh

Request / Respons

Contoh respons

Kolom penting