Gestion
Mettre à jour une clé API
Mettre à jour une clé API dans le Workspace actuel.
Aperçu
Utilisez ce point de terminaison pour mettre à jour le nom, la limite d'utilisation, les modèles autorisés, l'expiration ou le statut d'une clé API utilisateur existante.
Corps de la requête
Au moins un champ doit être fourni.
| Champ | Type | Valeur par défaut / Limites | Remarques |
|---|---|---|---|
status | enum | - | active, inactive, revoked |
name | string | longueur 1-50 | Nom d'affichage mis à jour |
limitAmount | number | string | null | 0–100000 USD | null signifie illimité ; 0 empêche toute dépense. Les chaînes décimales prennent en charge jusqu'à 6 décimales. |
limitCurrency | enum | USD par défaut | USD uniquement. Envoyer CNY renvoie 400 currency_retired. Lorsqu'il est défini, limitAmount est requis. |
models | string[] | - | Liste des modèles autorisés mise à jour |
deliveryPolicy | string | null | auto, verified, official, null | null hérite de la politique de distribution du Workspace. |
expiresAt | string | null | datetime RFC3339 | null supprime l'expiration |
Remarques
-
Les champs monétaires sont en USD uniquement. Les valeurs
CNYsont obsolètes et renvoient400 currency_retired. -
L'API Management ne permet pas la suppression. Utilisez
inactivepour une suspension temporaire etrevokedpour révoquer définitivement une clé. -
Remplacez une clé révoquée par une nouvelle. Définir une clé révoquée sur
activerenvoie409 api_key_revoked. -
suspendedpeut apparaître dans les réponses, mais vous ne pouvez pas l'envoyer.
Requête
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
}'Requête / Réponse
Cette page fournit le schéma OpenAPI et des exemples de requêtes prêts à être copiés. Envoyez les requêtes de gestion depuis votre terminal ou votre client avec un Management Token ; l'envoi direct n'est pas disponible sur cette page.
Réponse
{
"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
}Champs importants
active, inactive, suspended ou revoked.null signifie illimité.null signifie illimité.auto, verified, official, null. null hérite de la politique de distribution du Workspace.null pour aucune expiration.null lorsqu'elle n'a pas été utilisée.Autorisation
ManagementTokenAuth Authentification par jeton de gestion. Créez ou gérez vos jetons de gestion dans Dashboard > API > Management Tokens.
Emplacement: header
Paramètres de chemin
Corps de la requête
application/json
Au moins un champ doit être fourni.
1 <= propertiesRéponse
application/json
application/json
application/json
application/json
application/json
application/json