Verwaltung
API-Key aktualisieren
Aktualisiert einen vorhandenen Benutzer-API-Key für die aktuelle Organisation.
Überblick
Verwenden Sie diesen Endpunkt, um Name, Nutzungslimit, erlaubte Modelle, Ablaufzeit oder Status eines vorhandenen Benutzer-API-Keys zu aktualisieren.
Request-Body
Mindestens ein Feld muss angegeben werden.
| Feld | Typ | Standard / Grenzen | Beschreibung |
|---|---|---|---|
status | enum | - | active, inactive, revoked |
name | string | Länge 1-50 | Aktualisierter Anzeigename |
limitAmount | number | string | null | 0–100000 USD | null bedeutet unbegrenzt; 0 verhindert Ausgaben. Dezimalstrings erlauben bis zu 6 Nachkommastellen. |
limitCurrency | enum | Standardwert USD | Nur USD. Das Senden von CNY gibt 400 currency_retired zurück. Bei Angabe ist auch limitAmount erforderlich. |
models | string[] | - | Aktualisierte Allowlist für logische Modelle |
deliveryPolicy | string | null | auto, verified, official, null | null übernimmt die Zustellrichtlinie des Workspace. |
expiresAt | string | null | RFC3339-Datetime | null entfernt die Ablaufzeit |
Hinweise
-
Geldbetragsfelder unterstützen ausschließlich USD.
CNY-Eingaben sind außer Betrieb genommen und geben400 currency_retiredzurück. -
Hard Delete wird in Management API v1 bewusst nicht unterstützt.
-
revokedist für den normalen operativen Einsatz ein Endzustand; erstellen Sie lieber einen neuen Key, statt auf eine spätere Reaktivierung zu hoffen.
Anfrage
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 enthält das OpenAPI-Schema und kopierbare Anfragebeispiele. Senden Sie Verwaltungsanfragen mit einem Management Token über Ihr Terminal oder Ihren Client; direktes Senden ist auf dieser Seite nicht verfügbar.
Antwort
{
"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
}Wichtige Felder
active, inactive, suspended oder revoked.null bedeutet unbegrenzt.null bedeutet unbegrenzt.auto, verified, official, null. null übernimmt die Zustellrichtlinie des Workspace.null ohne Ablaufdatum.null, wenn noch nicht verwendet.Autorisierung
ManagementTokenAuth Management-Token-Authentifizierung. Erstellen oder verwalten Sie Management-Token unter Dashboard > API > Management Tokens.
Ort: header
Pfadparameter
Anfragekörper
application/json
Mindestens ein Feld muss angegeben werden.
1 <= propertiesAntwort
application/json
application/json
application/json
application/json
application/json
application/json