Yönetim

API Anahtarını Güncelle

Mevcut Workspace içindeki bir API anahtarını güncelleyin.

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

Genel Bakış

Mevcut bir kullanıcı API anahtarının adını, kullanım limitini, izin verilen modellerini, geçerlilik süresini veya durumunu güncellemek için bu uç noktayı kullanın.

İstek Gövdesi

En az bir alan sağlanmalıdır.

AlanTürVarsayılan / LimitlerNotlar
statusenum-active, inactive, revoked
namestringuzunluk 1-50Güncellenen görünen ad
limitAmountnumber | string | null0–100000 USDnull sınırsız anlamına gelir; 0 harcamayı engeller. Ondalık dize değerleri 6 basamağa kadar desteklenir.
limitCurrencyenumvarsayılan USDYalnızca USD. CNY gönderilmesi 400 currency_retired döndürür. Ayarlandığında, limitAmount zorunludur.
modelsstring[]-Güncellenen model izin listesi
deliveryPolicystring | nullauto, verified, official, nullnull, Workspace teslimat politikasını devralır.
expiresAtstring | nullRFC3339 datetimenull geçerlilik süresini temizler

Notlar

  • Para birimi alanları yalnızca USD içindir. CNY girişleri kullanımdan kaldırılmıştır ve 400 currency_retired döndürür.

  • Management API silme işlemi sağlamaz. Geçici bir duraklatma için inactive, bir anahtarı kalıcı olarak kullanımdan kaldırmak için revoked kullanın.

  • İptal edilen bir anahtarı yenisiyle değiştirin. İptal edilmiş bir anahtarı active olarak ayarlamak 409 api_key_revoked döndürür.

  • suspended yanıtlarda görünebilir, ancak bunu gönderemezsiniz.

Örnek

İstek

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

İstek / Yanıt

Bu sayfa OpenAPI şemasını ve kopyalanabilir istek örneklerini sağlar. Yönetim isteklerini bir Management Token ile terminalinizden veya istemcinizden gönderin; bu sayfadan doğrudan gönderme kullanılamaz.

Yanıt örneği

Yanıt

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
}

Önemli alanlar

idstring
Sonraki Management API çağrılarında kullanılan API anahtarı tanımlayıcısı.
namestring
API anahtarı için görünen ad.
key_prefixstring
Görüntüleme ve destek amaçlı gizli olmayan anahtar öneki.
statusstring
active, inactive, suspended veya revoked değerlerinden biri.
limit_amountnumber | null
Görüntüleme amacıyla bir JSON sayısı olarak USD cinsinden harcama limiti. null sınırsız anlamına gelir.
limit_amount_decimalstring | null
Ondalık dize olarak USD cinsinden tam harcama limiti. null sınırsız anlamına gelir.
used_amountnumber
Görüntüleme amacıyla bir JSON sayısı olarak USD cinsinden birikmiş kullanım.
used_amount_decimalstring
Ondalık dize olarak USD cinsinden tam birikmiş kullanım.
modelsstring[]
Anahtar başına model izin listesi. Boş dizi, anahtar düzeyinde ek bir model kısıtlaması olmadığı anlamına gelir.
delivery_policystring | null
auto, verified, official, null. null, Workspace teslimat politikasını devralır.
expires_atstring | null
Anahtarın süresinin dolduğu ISO zaman damgası veya geçerlilik süresi olmaması durumunda null.
last_used_atstring | null
En son kullanım için ISO zaman damgası veya kullanılmadığında null.
created_atstring
ISO oluşturulma zaman damgası.

Yetkilendirme

ManagementTokenAuth
AuthorizationBearer <token>

Yönetim belirteci kimlik doğrulaması. Yönetim Belirteçlerini Dashboard > API > Management Tokens bölümünden oluşturun veya yönetin.

Konum: header

Yol parametreleri

keyId*string

İstek gövdesi

application/json

En az bir alan sağlanmalıdır.

Özellikler1 <= properties

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json