Verwaltung

API-Key aktualisieren

Einen API-Key im aktuellen Workspace aktualisieren.

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

Übersicht

Verwenden Sie diesen Endpunkt, um den Namen, das Nutzungslimit, die erlaubten Modelle, das Ablaufdatum oder den Status eines bestehenden Benutzer-API-Keys zu aktualisieren.

Request-Body

Es muss mindestens ein Feld angegeben werden.

FeldTypStandard / LimitsHinweise
statusenum-active, inactive, revoked
namestringLänge 1-50Aktualisierter Anzeigename
limitAmountnumber | string | null0–100000 USDnull bedeutet unbegrenzt; 0 verhindert Ausgaben. Dezimal-Strings unterstützen bis zu 6 Dezimalstellen.
limitCurrencyenumStandard USDNur USD. Das Senden von CNY gibt 400 currency_retired zurück. Wenn gesetzt, ist limitAmount erforderlich.
modelsstring[]-Aktualisierte Modell-Allowlist
deliveryPolicystring | nullauto, verified, official, nullnull erbt die Delivery Policy des Workspace.
expiresAtstring | nullRFC3339 datetimenull löscht das Ablaufdatum

Hinweise

  • Währungsfelder unterstützen ausschließlich USD. CNY-Eingaben sind veraltet und geben 400 currency_retired zurück.

  • Die Management-API bietet keine Löschung an. Verwenden Sie inactive für eine vorübergehende Pausierung und revoked, um einen Key dauerhaft stillzulegen.

  • Ersetzen Sie einen widerrufenen Key durch einen neuen. Das Setzen eines widerrufenen Keys auf active gibt 409 api_key_revoked zurück.

  • suspended kann in Antworten vorkommen, kann jedoch nicht gesendet werden.

Beispiel

Anfrage

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

Anfrage / Antwort

Diese Seite bietet das OpenAPI-Schema und kopierbare Request-Beispiele. Senden Sie Management-Requests über Ihr Terminal oder Ihren Client mit einem Management-Token; das direkte Senden ist auf dieser Seite nicht verfügbar.

Response-Beispiel

Antwort

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
}

Wichtige Felder

idstring
API-Key-Identifikator, der in nachfolgenden Management-API-Aufrufen verwendet wird.
namestring
Anzeigename für den API-Key.
key_prefixstring
Nicht-geheimer Key-Präfix für Anzeige und Support.
statusstring
Einer der Werte active, inactive, suspended oder revoked.
limit_amountnumber | null
Ausgabenlimit in USD als JSON-Zahl zur Anzeige. null bedeutet unbegrenzt.
limit_amount_decimalstring | null
Exaktes Ausgabenlimit in USD als Dezimal-String. null bedeutet unbegrenzt.
used_amountnumber
Akkumulierte Nutzung in USD als JSON-Zahl zur Anzeige.
used_amount_decimalstring
Exakte akkumulierte Nutzung in USD als Dezimal-String.
modelsstring[]
Modell-Allowlist pro Key. Ein leeres Array bedeutet keine zusätzliche Modellbeschränkung auf Key-Ebene.
delivery_policystring | null
auto, verified, official, null. null erbt die Delivery Policy des Workspace.
expires_atstring | null
ISO-Zeitstempel, wann der Key abläuft, oder null für kein Ablaufdatum.
last_used_atstring | null
ISO-Zeitstempel der letzten Nutzung oder null, wenn ungenutzt.
created_atstring
ISO-Erstellungszeitstempel.

Autorisierung

ManagementTokenAuth
AuthorizationBearer <token>

Management-Token-Authentifizierung. Erstellen oder verwalten Sie Management-Token unter Dashboard > API > Management Tokens.

Ort: header

Pfadparameter

keyId*string

Anfragekörper

application/json

Mindestens ein Feld muss angegeben werden.

Eigenschaften1 <= properties

Antwort

application/json

application/json

application/json

application/json

application/json

application/json