Mettre à jour une API Key

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

{
  "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-mini",
    "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"
}

Vue d’ensemble

Utilisez cet endpoint pour mettre à jour le nom, la limite d’usage, les modèles autorisés, l’expiration ou le statut d’une API Key utilisateur existante.

Corps de la requête

Au moins un champ doit être fourni dans la requête PATCH.

Champ	Type	Valeurs par défaut / limites	Description
`status`	enum	-	`active`, `inactive`, `revoked`
`name`	string	longueur `1-50`	Nom affiché mis à jour
`limitAmount`	number \| null	min. `0`, entrée max. `1000000`	`null` = illimité, `0` = quota nul. Les valeurs positives sont normalisées vers un plafond stocké qui ne peut pas dépasser l’équivalent de `100000` USD.
`limitCurrency`	enum	valeur par défaut `USD`	USD uniquement. L’envoi de `CNY` renvoie `400 currency_retired`.
`models`	string[]	-	Liste d’autorisation des modèles logiques mise à jour
`expiresAt`	string \| null	datetime RFC3339	`null` efface la date d’expiration

Notes

Les champs monétaires prennent uniquement en charge l’USD. Les entrées CNY sont abandonnées et renvoient 400 currency_retired.
Les champs monétaires sont réservés au USD. Les entrées CNY sont obsolètes et renvoient 400 currency_retired.
Le hard delete n’est volontairement pas pris en charge dans Management API v1.
revoked est terminal pour l’usage opérationnel courant ; créez une nouvelle clé au lieu d’attendre un futur flux de réactivation.

Exemple

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

Utilisez le panneau OpenAPI interactif ci-dessus pour obtenir le schéma exact et les champs de réponse.

Exemple de 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-mini",
    "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"
}

Champs importants

string

Identifiant de clé API utilisé dans les appels ultérieurs à l’API de gestion.

string

Nom d’affichage de la clé API.

string

Préfixe de clé non secret pour l’affichage et l’assistance.

string

L’une des valeurs active, inactive ou revoked.

number | null

Plafond de dépenses en USD renvoyé sous forme de nombre JSON pour l’affichage. null signifie aucune limite.

string | null

Plafond de dépenses exact en USD renvoyé sous forme de chaîne décimale. null signifie aucune limite.

number

Dépenses d’utilisation cumulées en USD renvoyées sous forme de nombre JSON pour l’affichage.

string

Dépenses d’utilisation cumulées exactes en USD renvoyées sous forme de chaîne décimale.

string[]

Liste des modèles autorisés par clé. Un tableau vide signifie qu’aucune restriction de modèle supplémentaire ne s’applique au niveau de la clé.

string | null

Horodatage ISO d’expiration de la clé, ou null si elle n’expire pas.

string | null

Horodatage ISO de la dernière utilisation, ou null si elle n’a jamais été utilisée.

string

Horodatage ISO de création.

Essentiel

Texte

Fichiers & lots

Images

Audio & temps réel

Musique

Vidéo & ressources

Worlds

3D

Tâches asynchrones

Gemini natif

Gestion

Mettre à jour une API Key

Vue d’ensemble

Corps de la requête

Notes

Exemple

Requête / Réponse

Exemple de réponse

Champs importants

​Vue d’ensemble

​Corps de la requête

​Notes

​Exemple

​Requête / Réponse

​Exemple de réponse

​Champs importants

Vue d’ensemble

Corps de la requête

Notes

Exemple

Requête / Réponse

Exemple de réponse

Champs importants