Aller au contenu
Centre d'aide Clevera

Corriger les erreurs des agents IA et de l'API

Chaque message qu'un agent IA, un script ou une personne peut voir avec l'API, le serveur MCP et la page Agents IA & API de Clevera, regroupés par cause : jetons, forfait, autorisations, travail payant, limites de débit, conflits et applications connectées, avec la solution.

Mis à jour 10 min de lecture

Lorsque Clevera refuse l'appel d'un agent, l'agent reçoit un code et un message indiquant la marche à suivre. Cet article répertorie chaque message qu'un agent, un script ou une personne peut voir avec Agents IA & API, sa cause et comment le corriger. Via l'API REST, le code se trouve dans error.code ; via MCP, le même message est renvoyé sous forme d'erreur d'outil.

Le jeton n'est pas accepté

Message Code Cause Solution
"Send a Clevera agent token (Authorization: Bearer clv_agent_…) or connect through OAuth. Create a token in Integrations → AI agents & API." unauthenticated Aucun jeton n'a été envoyé. Envoyez Authorization: Bearer <token>. Vérifiez que CLEVERA_TOKEN est défini là où l'agent s'exécute.
"That is not a valid Clevera agent token. Create one in Integrations → AI agents & API." unauthenticated La valeur est mal saisie, tronquée ou n'est pas un jeton Clevera. Collez à nouveau le jeton complet.
"Unknown token. It may have been deleted; create a new one in Integrations → AI agents & API." unauthenticated Clevera ne reconnaît pas ce jeton. Créez un nouveau jeton.
"OAuth connector tokens work on the MCP server only. Use a static token for the REST API." unauthenticated La connexion d'une application a été utilisée sur l'API REST. Utilisez un jeton d'API pour REST.
"This token has expired. Create a new one in Integrations → AI agents & API." token_expired Sa durée de vie a expiré. Créez un nouveau jeton.
"This token was revoked." token_revoked Quelqu'un l'a révoqué, il a été régénéré, son propriétaire est parti, ou Clevera l'a révoqué. Voir pourquoi un jeton a cessé de fonctionner.
"The account that owns this token is suspended." token_revoked Le compte du propriétaire est suspendu. Contactez le support.
"This token can't be used from this IP address." ip_not_allowed L'appel provient de l'extérieur de la liste d'adresses IP autorisées du jeton. Exécutez l'agent depuis une adresse autorisée ou créez un jeton avec la nouvelle adresse.

Le forfait ne l'inclut pas

Les agents IA & API (jetons, applications connectées et webhooks) sont disponibles avec les forfaits Pro, Business et Custom. Sur les forfaits Free et Starter, la page affiche "AI agents & API are included in Pro" avec Passer à Pro. La mise à niveau permet aux jetons, applications et webhooks existants de fonctionner à nouveau ; rien n'est supprimé.

Message Code Cause Solution
"The agent API is not on this workspace's plan. It is on Pro and up." plan_locked (HTTP 403) L'espace de travail est sur Free ou Starter, ou a été déplacé vers l'un d'eux. Chaque appel de jeton et d'application connectée est refusé. Passer à Pro. Les jetons qui n'ont pas expiré fonctionnent à nouveau.
Claude ou ChatGPT indique seulement qu'il n'a pas pu se connecter, ou ses outils Clevera échouent plan_locked en arrière-plan Le même refus de forfait, affiché par l'application comme une erreur de connexion générique. Mettez l'espace de travail à niveau vers Pro, puis réessayez dans l'application.
"The API and agent access are not on your plan." — Création d'un jeton, ou clic sur Approuver sur une requête d'agent, hors Pro. Passer à Pro. Refuser fonctionne toujours.
"The API and agent access are on Pro and up." / "Claude.ai and ChatGPT connectors are on Pro and up." / "Webhooks are on Pro and up." — Un contrôle verrouillé sur Free ou Starter. Passer à Pro.
workspace "(plan doesn’t include connected apps)" / "This workspace’s plan does not include connected apps." — Connexion de Claude ou ChatGPT à un espace de travail hors Pro. Mettez à niveau ou choisissez un autre espace de travail sur l'écran de connexion.
Régénérer le secret ouvre la boîte de dialogue de mise à niveau — Les secrets ne peuvent pas être régénérés hors Pro. Passer à Pro ou révoquer le jeton.
"Webhooks are not on your plan." — Envoyer un événement de test ou Redistribuer hors Pro. Rien n'est envoyé ; les tentatives en attente échouent avec plan_locked. Passer à Pro.
"Your plan does not include paid agent work. Upgrade to let agents start it." plan_locked Travail payant sur un forfait qui ne l'inclut pas. Passer à Pro.

Le jeton n'est pas autorisé à

Message Code Cause Solution
"This token lacks the ability ability. Ask the workspace member who owns it for a token that has it." forbidden_ability Le jeton n'a pas l'autorisation nécessaire pour cet appel. Créez un jeton avec cette autorisation. Voir Autorisations de l'agent.
"The token owner's current role in this workspace does not allow ability." forbidden_role Le rôle du propriétaire a changé depuis la création du jeton. Le jeton affiche Dépasse le rôle. Quelqu'un avec le rôle approprié crée le jeton.
"Your role can’t grant some of these abilities." / "Your role can’t grant: abilities." — Création d'un jeton avec des autorisations dépassant votre rôle. Décochez-les ou demandez à un propriétaire ou un administrateur.
"You can't do this in this workspace." forbidden Le rôle ou l'accès du propriétaire ne permet pas cette action sur cet élément. Vérifiez le rôle du propriétaire et l'accès à la collection.
"The token owner can view this article but not edit it (collection access)." forbidden_item L'élément est dans une collection que le propriétaire peut seulement voir. Donnez au propriétaire un accès en modification à la collection.
"No item with that id in this token's scope. List or search first and use a returned id." not_found Identifiant erroné, ou l'élément est en dehors des sites du jeton ou de l'accès du propriétaire. Listez ou recherchez, puis utilisez un identifiant renvoyé.
"This content is live on a published site, so changing it needs the site:publish ability." live_content_needs_publish Modification (ou traduction) d'un article de site de documentation en ligne sans droits de publication. Donnez au jeton site:publish, ou laissez-le soumettre pour révision.
"This article is also shown on a site this token cannot change. …" shared_outside_scope L'article apparaît sur un site en dehors des sites du jeton. Utilisez un jeton qui couvre tous les sites où il apparaît, ou laissez une note de révision.
"This site is paused or offline and read-only. A workspace owner can re-activate it in Docs." site_paused Le site de documentation est en pause. Réactivez le site.
Message Code Cause Solution
"This would pass the token's spend cap. A workspace admin can raise it." cap_exceeded Le devis dépasse le plafond Par tâche, Par jour ou Par mois du jeton. Attendez le jour ou le mois suivant, ou créez un jeton avec des plafonds plus élevés.
Un message indiquant que les crédits sont épuisés insufficient_credits L'espace de travail n'a pas assez de crédits. Achetez des crédits ou attendez l'allocation.
"Your workspace cannot spend credits right now." plan_locked La facturation bloque les dépenses, par exemple un paiement est dû. Vérifiez la Facturation.
"This quote has expired. Ask for a new quote." quote_expired Les devis durent 15 minutes. Demandez un nouveau devis.
"This quote was already used. Ask for a new quote." quote_used Un devis lance une tâche. Demandez un nouveau devis.
"This quote is for another kind of job." quote_mismatch Un devis vidéo a été utilisé pour lancer un clip, par exemple. Utilisez l'appel de lancement correspondant.
"Another start is being checked. Try again in a moment." busy Deux lancements au même moment. Réessayez après une seconde.
La tâche attend avec needs_input — Elle attend une approbation sur Requêtes de l'agent. Un propriétaire ou un administrateur l'approuve ou la refuse sous 24 heures.
La tâche se termine expired — Personne n'a décidé sous 24 heures. Relancez et approuvez-la.
"This job can no longer be canceled." not_cancelable La tâche est déjà terminée ou a dépassé le point d'annulation. —

Messages d'entrée courants lors de la demande de vidéos : "This recording is still processing. Please wait until it is ready.", "Choose how_to, product_demo, cleanup or styled_video.", "Choose 1080p, 2k or 4k.", "Exports are always 60 fps.", "This item is an article; only videos can be exported.", "Social clips cannot be translated by agents yet.", "This language is already translated.", "That material was not found in this workspace. Upload it first."

Trop de requêtes

Message Code Limite
"This token is over its request rate. Wait and retry." rate_limited 300 requêtes par minute par jeton
"This workspace is over its agent request rate. Wait and retry." rate_limited 1 200 par minute par espace de travail
"Too many writes from this token. Wait and retry." rate_limited 60 écritures par minute par jeton
"This token reached its daily write limit. Try again tomorrow." rate_limited 2 000 écritures par jour par jeton
"This token reached its hourly publish limit. Try again later." rate_limited 10 publications par heure par jeton
"Too many uploads from this token. Wait and retry." rate_limited 30 téléchargements par minute
"This token reached its daily upload volume. Try again tomorrow." rate_limited 500 Mo par jour par jeton
"Writes from this token are paused after an unusual burst of changes. The workspace owner was notified." rate_limited Activité inhabituelle : les écritures sont suspendues pendant 10 minutes
"Too many requests. Wait and retry." rate_limited 60 par minute par adresse IP sans jeton valide

Les démarrages payants sont également limités à 20 par heure et par jeton, et à 100 par jour et par espace de travail. Chaque 429 possède un en-tête Retry-After ; attendez la durée indiquée.

Contenu et nouvelles tentatives

Message Code Correctif
"The content changed since you read it. Re-read it …, merge your change and retry with that id." revision_conflict L'agent relit la page et réapplique sa modification.
"This idempotency key was used for a different request." idempotency_conflict / idempotency_key_reused Utilisez un nouveau Idempotency-Key pour une nouvelle requête.
— idempotency_in_progress La première requête avec cette clé est toujours en cours. Patientez, puis réessayez avec la même clé.

Jetons et page

Situation Cause Correctif
Nouveau jeton est désactivé "Your workspace has reached its limit of 50 active tokens. Revoke one first." Révoquez un jeton que vous n'utilisez pas.
Aucune option Régénérer le secret Seul le créateur du jeton peut le régénérer, et ce, une seule fois. "Only the person who created this token can regenerate it. You can revoke it." Régénérez le jeton plus récent ou créez-en un.
"This token was already regenerated, revoked or has expired; use its replacement or create a new one." Le secret a déjà été régénéré. Utilisez le jeton de remplacement.
Vous ne voyez pas le jeton d'un collègue Seuls les propriétaires et les administrateurs voient tous les jetons. Demandez à un propriétaire ou à un administrateur.
Vous ne pouvez pas approuver une requête : "An owner or admin decides" Seuls les propriétaires et les administrateurs approuvent les dépenses. Demandez à un propriétaire ou à un administrateur.
"Only owners and admins manage webhooks" Votre rôle ne permet pas de gérer les webhooks. Demandez à un propriétaire ou à un administrateur.

Connexion à Claude ou ChatGPT

À l'écran Correctif
"This request expired" "Too much time passed since the app asked. Start connecting again from the app."
"This app isn’t registered" Supprimez le connecteur dans l'application et ajoutez-le à nouveau.
"This request can’t be trusted" "Nothing was shared. Start connecting again from the app." Ne vous connectez pas si le problème persiste.
"Choose a workspace you are a member of." Choisissez l'un de vos espaces de travail.
"Revoked: token reuse detected" sur une application connectée La connexion de l'application a été réutilisée, Clevera l'a donc révoquée. Connectez à nouveau l'application.

Toujours bloqué

Contactez le support avec le request_id de l'erreur, le nom du jeton (jamais le jeton lui-même) et l'heure de l'appel.

Gérer les jetons APIPourquoi un jeton a cessé de fonctionner.Autorisations de l'agentQuelle autorisation est nécessaire pour un appel.Contrôler les dépenses et les approbations de l'agentPlafonds, quotas et approbations.Utiliser l'API RESTFormat d'erreur et limites de débit.