API publique

Supprimer une clé API

Management key required. Supprime définitivement une clé API de modèle en conservant son historique d’utilisation.

api_key_id dans l’URL correspond au champ id, au format ak_..., renvoyé par Créer une clé API de modèle (POST /public/v1/api-keys). Conservez-le pour désactiver ou supprimer la clé, définir son plafond et consulter son utilisation. Le champ key (apikey-...) sert aux appels de modèles ; les appels de gestion utilisent toujours mgmt-... dans l’en-tête d’autorisation.

DELETE
/public/v1/api-keys/{api_key_id}

Management key required. Use a Management API Key (mgmt-...) for your Team, created by a Team Owner. Requests use the Team associated with that key.

No request body. Soft-deletes the key, preserving its identity and usage history. A deleted key cannot be enabled or have its allowance changed. Repeating deletion of this Team's key returns 204; unknown or other-Team identifiers return 404. Follows existing gateway cache refresh behavior.

Authorization

ManagementKeyBearer
AuthorizationBearer <token>

Management key required. Send Authorization: Bearer mgmt-....

In: header

Path Parameters

api_key_id*string

The id returned by Create a model API key (POST /public/v1/api-keys). Copy the complete ak_... value into this path parameter. Use the mgmt-... management key in the authorization header; the returned key (apikey-...) is for model calls.

Match^ak_[0-9A-Za-z]{22}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/public/v1/api-keys/ak_0123456789ABCDEFGHIJKL"
Empty

Last updated on