TokenLab

Gestion

Mettre à jour une clé API

Mettre à jour une clé API dans le Workspace actuel.

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

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.

ChampTypeValeur par défaut / LimitesRemarques
statusenum-active, inactive, revoked
namestringlongueur 1-50Nom d'affichage mis à jour
limitAmountnumber | string | null0–100000 USDnull signifie illimité ; 0 empêche toute dépense. Les chaînes décimales prennent en charge jusqu'à 6 décimales.
limitCurrencyenumUSD par défautUSD uniquement. Envoyer CNY renvoie 400 currency_retired. Lorsqu'il est défini, limitAmount est requis.
modelsstring[]-Liste des modèles autorisés mise à jour
deliveryPolicystring | nullauto, verified, official, nullnull hérite de la politique de distribution du Workspace.
expiresAtstring | nulldatetime RFC3339null supprime l'expiration

Remarques

  • Les champs monétaires sont en USD uniquement. Les valeurs CNY sont obsolètes et renvoient 400 currency_retired.

  • L'API Management ne permet pas la suppression. Utilisez inactive pour une suspension temporaire et revoked pour révoquer définitivement une clé.

  • Remplacez une clé révoquée par une nouvelle. Définir une clé révoquée sur active renvoie 409 api_key_revoked.

  • suspended peut apparaître dans les réponses, mais vous ne pouvez pas l'envoyer.

Exemple

Requête

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

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.

Exemple de réponse

Réponse

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
}

Champs importants

idstring
Identifiant de la clé API utilisé dans les appels ultérieurs à l'API Management.
namestring
Nom d'affichage de la clé API.
key_prefixstring
Préfixe de clé non secret destiné à l'affichage et au support.
statusstring
L'un des statuts suivants : active, inactive, suspended ou revoked.
limit_amountnumber | null
Plafond de dépenses en USD sous forme de nombre JSON pour l'affichage. null signifie illimité.
limit_amount_decimalstring | null
Plafond de dépenses exact en USD sous forme de chaîne décimale. null signifie illimité.
used_amountnumber
Utilisation cumulée en USD sous forme de nombre JSON pour l'affichage.
used_amount_decimalstring
Utilisation cumulée exacte en USD sous forme de chaîne décimale.
modelsstring[]
Liste des modèles autorisés par clé. Un tableau vide signifie qu'aucune restriction supplémentaire sur les modèles ne s'applique au niveau de la clé.
delivery_policystring | null
auto, verified, official, null. null hérite de la politique de distribution du Workspace.
expires_atstring | null
Horodatage ISO de l'expiration de la clé, ou null pour aucune expiration.
last_used_atstring | null
Horodatage ISO de la dernière utilisation, ou null lorsqu'elle n'a pas été utilisée.
created_atstring
Horodatage ISO de création.

Autorisation

ManagementTokenAuth
AuthorizationBearer <token>

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

keyId*string

Corps de la requête

application/json

Au moins un champ doit être fourni.

Propriétés1 <= properties

Réponse

application/json

application/json

application/json

application/json

application/json

application/json