Verwaltung
API-Key aktualisieren
Einen API-Key im aktuellen Workspace aktualisieren.
Ü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.
| Feld | Typ | Standard / Limits | Hinweise |
|---|---|---|---|
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. Dezimal-Strings unterstützen bis zu 6 Dezimalstellen. |
limitCurrency | enum | Standard USD | Nur USD. Das Senden von CNY gibt 400 currency_retired zurück. Wenn gesetzt, ist limitAmount erforderlich. |
models | string[] | - | Aktualisierte Modell-Allowlist |
deliveryPolicy | string | null | auto, verified, official, null | null erbt die Delivery Policy des Workspace. |
expiresAt | string | null | RFC3339 datetime | null löscht das Ablaufdatum |
Hinweise
-
Währungsfelder unterstützen ausschließlich USD.
CNY-Eingaben sind veraltet und geben400 currency_retiredzurück. -
Die Management-API bietet keine Löschung an. Verwenden Sie
inactivefür eine vorübergehende Pausierung undrevoked, um einen Key dauerhaft stillzulegen. -
Ersetzen Sie einen widerrufenen Key durch einen neuen. Das Setzen eines widerrufenen Keys auf
activegibt409 api_key_revokedzurück. -
suspendedkann in Antworten vorkommen, kann jedoch nicht gesendet werden.
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 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.
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-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
active, inactive, suspended oder revoked.null bedeutet unbegrenzt.null bedeutet unbegrenzt.auto, verified, official, null. null erbt die Delivery Policy des Workspace.null für kein Ablaufdatum.null, wenn ungenutzt.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