--- title: Mettre à jour une clé API | RunAPI description: Mettre à jour une clé API Standard existante et récupérer son résumé d'utilisation actuel. url: https://runapi.ai/fr/docs/api/management/keys/update.md canonical: https://runapi.ai/fr/docs/api/management/keys/update locale: fr --- > Version HTML: https://runapi.ai/fr/docs/api/management/keys/update > Index du site pour les agents: https://runapi.ai/llms.txt # Mettre à jour une clé API Mettre à jour une clé API Standard existante et récupérer son résumé d'utilisation actuel. ## Point de terminaison PATCH /api/v1/keys/:id URL de base: https://runapi.ai Version de l'API: v1 Authentification: Authorization: Bearer YOUR_MANAGEMENT_API_KEY Autorisation: Nécessite une clé API de gestion d'administrateur de compte et n'autorise que les clés appartenant à son utilisateur. ## Requête Envoyez les valeurs uniquement à l'emplacement de requête indiqué. ### Corps JSON ```json { "allowed_models": { "description": "Liste d'autorisation de modèles de remplacement ; null ou un tableau vide efface la liste.", "required": false, "type": "array | null" }, "credit_limit_cents": { "description": "Plafond de dépenses en centimes USD ; null supprime le plafond et l'intervalle de réinitialisation.", "required": false, "type": "integer | null" }, "credit_limit_reset_interval": { "description": "Cadence de réinitialisation du plafond de dépenses.", "enum": [ "daily", "weekly", "monthly" ], "required": false, "type": "string | null" }, "credit_limit_windows": { "description": "Plafonds de dépenses glissants de remplacement indexés par 1h, 1d ou 7d ; un objet vide efface tous les plafonds glissants.", "required": false, "type": "object" }, "enabled": { "description": "Indique si les requêtes utilisant cette clé sont acceptées.", "required": false, "type": "boolean" }, "name": { "description": "Nom convivial de remplacement pour la clé API.", "required": false, "type": "string" } } ``` ### Paramètres de chemin ```json { "id": { "description": "Identifiant de préfixe de clé API, par exemple token_123.", "required": true, "type": "string" } } ``` ## Réponse de succès HTTP 200 - PATCH /api/v1/keys/:id ```json { "allowed_models": [ "gpt-5.4" ], "created_at": "2026-07-27T10:00:00.000Z", "credit_limit_cents": 1000, "credit_limit_reset_interval": "daily", "credit_limit_windows": {}, "credit_usage_cents_by_model": { "gpt-5.4": 250 }, "credit_usage_cents_this_month": 250, "credit_usage_cents_this_week": 100, "credit_usage_cents_today": 25, "credit_usage_cents_total": 250, "enabled": true, "guardrail_id": "guardrail_123", "id": "token_123", "last_used_at": null, "masked_token": "runapi_abc...wxyz", "name": "Production primary" } ``` ## Réponse d'erreur (401) HTTP 401 ### Schéma de réponse ```json { "properties": { "error": { "description": "Message d'erreur lisible par l'humain.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### Exemple de réponse ```json { "error": "Authentication required" } ``` ## Réponse d'erreur (403) HTTP 403 ### Schéma de réponse ```json { "properties": { "error": { "description": "Message d'erreur lisible par l'humain.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### Exemple de réponse ```json { "error": "Management API key required" } ``` ## Réponse d'erreur (403) HTTP 403 ### Schéma de réponse ```json { "properties": { "error": { "description": "Message d'erreur lisible par l'humain.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### Exemple de réponse ```json { "error": "Account admin required" } ``` ## Réponse d'erreur (400) HTTP 400 ### Schéma de réponse ```json { "oneOf": [ { "properties": { "error": { "description": "Message d'erreur lisible par l'humain.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false }, { "properties": { "error": { "description": "Résumé de validation lisible par l'humain.", "type": "string" }, "errors": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "description": "Messages de validation indexés par champ de requête public, avec un tableau de chaînes lisibles par l'humain pour chaque champ.", "type": "object" } }, "required": [ "error", "errors" ], "type": "object", "unevaluatedProperties": false } ] } ``` ### Exemple de réponse ```json { "error": "page must be an integer" } ``` ## Réponse d'erreur (404) HTTP 404 ### Schéma de réponse ```json { "properties": { "error": { "description": "Message d'erreur lisible par l'humain.", "type": "string" } }, "required": [ "error" ], "type": "object", "unevaluatedProperties": false } ``` ### Exemple de réponse ```json { "error": "Resource not found" } ``` ## Réponse d'erreur (422) HTTP 422 ### Schéma de réponse ```json { "properties": { "error": { "description": "Résumé de validation lisible par l'humain.", "type": "string" }, "errors": { "additionalProperties": { "items": { "type": "string" }, "type": "array" }, "description": "Messages de validation indexés par champ de requête public, avec un tableau de chaînes lisibles par l'humain pour chaque champ.", "type": "object" } }, "required": [ "error", "errors" ], "type": "object", "unevaluatedProperties": false } ``` ### Exemple de réponse ```json { "error": "Validation failed", "errors": { "base": [ "Validation failed" ] } } ``` ## Exemple cURL ### curl ```curl curl -X PATCH https://runapi.ai/api/v1/keys/token_123 \ -H 'Authorization: Bearer YOUR_MANAGEMENT_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"name":"Production primary","enabled":true,"credit_limit_windows":{}}' ``` ## Référence associée - [Clés API](https://runapi.ai/fr/docs/api/management/keys.md) - [Objet clé API](https://runapi.ai/fr/docs/api/management/keys/object.md) --- ## Plus de ressources de RunAPI - [Accueil](https://runapi.ai/fr/.md) - [Catalogue de modèles](https://runapi.ai/fr/models.md) - [Tarifs](https://runapi.ai/fr/pricing.md) - [Fournisseurs](https://runapi.ai/fr/models) - [Documentation](https://runapi.ai/fr/docs/guides) - [SDK](https://runapi.ai/fr/sdk.md) - [CLI](https://runapi.ai/fr/cli.md) - [Serveur MCP](https://runapi.ai/fr/mcp.md) - [Claude Code vs Cursor](https://runapi.ai/fr/claude-code-vs-cursor.md) - [Configuration de l’API Cursor](https://runapi.ai/fr/cursor-api-setup.md) - [RunAPI vs OpenRouter](https://runapi.ai/fr/openrouter-alternative.md) - [Entreprise](https://runapi.ai/fr/contact.md) - [Contact](https://runapi.ai/fr/contact.md) - [Conditions](https://runapi.ai/fr/terms.md) - [Confidentialité](https://runapi.ai/fr/privacy.md) - [Index du site pour les agents](https://runapi.ai/llms.txt) Contact: contact@runapi.ai ## Données structurées ```json [ { "@context": "https://schema.org", "inLanguage": "fr", "@type": "WebSite", "name": "RunAPI", "url": "https://runapi.ai/fr", "potentialAction": { "@type": "SearchAction", "target": { "@type": "EntryPoint", "urlTemplate": "https://runapi.ai/fr/models?q={search_term_string}" }, "query-input": "required name=search_term_string" } }, { "@context": "https://schema.org", "inLanguage": "fr", "@type": "Organization", "name": "RunAPI", "url": "https://runapi.ai/fr", "logo": { "@type": "ImageObject", "url": "https://runapi.ai/fricon.svg" }, "sameAs": [ "https://github.com/runapi-ai" ] }, { "@context": "https://schema.org", "inLanguage": "fr", "@type": "TechArticle", "headline": "Mettre à jour une clé API", "description": "Mettre à jour une clé API Standard existante et récupérer son résumé d'utilisation actuel.", "url": "https://runapi.ai/fr/docs/api/management/keys/update", "mainEntityOfPage": "https://runapi.ai/fr/docs/api/management/keys/update" } ] ```