Naar inhoud springen
Clevera Help Center

AI agent- en API-fouten oplossen

Elk bericht dat een AI-agent, script of persoon kan zien via de API, MCP-server en de pagina AI agents & API van Clevera, gegroepeerd op oorzaak: tokens, abonnement, machtigingen, betaald werk, snelheidslimieten, conflicten en gekoppelde apps, inclusief de oplossing.

Bijgewerkt op 10 min leestijd

Wanneer Clevera een aanroep van een agent weigert, krijgt de agent een code en een bericht met instructies. Dit artikel bevat elk bericht dat een agent, script of persoon kan zien bij AI agents & API, wat de oorzaak is en hoe je dit oplost. Via de REST API staat de code in error.code; via MCP komt hetzelfde bericht terug als een tool-fout.

Het token wordt niet geaccepteerd

Bericht Code Oorzaak Oplossing
"Send a Clevera agent token (Authorization: Bearer clv_agent_…) or connect through OAuth. Create a token in Integrations → AI agents & API." unauthenticated Er is geen token verzonden. Verstuur Authorization: Bearer <token>. Controleer of CLEVERA_TOKEN is ingesteld waar de agent draait.
"That is not a valid Clevera agent token. Create one in Integrations → AI agents & API." unauthenticated De waarde is verkeerd getypt, afgekapt of is geen Clevera-token. Plak het volledige token opnieuw.
"Unknown token. It may have been deleted; create a new one in Integrations → AI agents & API." unauthenticated Clevera herkent dit token niet. Maak een nieuw token aan.
"OAuth connector tokens work on the MCP server only. Use a static token for the REST API." unauthenticated De inloggegevens van een gekoppelde app werden gebruikt op de REST API. Gebruik een API-token voor REST.
"This token has expired. Create a new one in Integrations → AI agents & API." token_expired De levensduur is verstreken. Maak een nieuw token aan.
"This token was revoked." token_revoked Iemand heeft het ingetrokken, het is opnieuw gegenereerd, de eigenaar is vertrokken of Clevera heeft het ingetrokken. Zie waarom een token niet meer werkt.
"The account that owns this token is suspended." token_revoked Het account van de eigenaar is opgeschort. Neem contact op met support.
"This token can't be used from this IP address." ip_not_allowed De aanroep kwam van buiten de IP-toegangslijst van het token. Laat de agent draaien vanaf een toegestaan adres, of maak een token aan met het nieuwe adres.

Het abonnement bevat dit niet

AI agents & API (tokens, gekoppelde apps en webhooks) zijn beschikbaar in de Pro-, Business- en Custom-abonnementen. Bij Free en Starter toont de pagina "AI agents & API are included in Pro" met Upgrade naar Pro. Door te upgraden werken bestaande tokens, apps en webhooks weer; er wordt niets verwijderd.

Bericht Code Oorzaak Oplossing
"The agent API is not on this workspace's plan. It is on Pro and up." plan_locked (HTTP 403) De workspace heeft een Free- of Starter-abonnement, of is daarnaar verplaatst. Elke aanroep van een token of gekoppelde app wordt geweigerd. Upgrade naar Pro. Tokens die niet zijn verlopen werken weer.
Claude of ChatGPT geeft alleen aan dat er geen verbinding kon worden gemaakt, of de Clevera-tools falen plan_locked op de achtergrond Dezelfde weigering op basis van het abonnement, door de app getoond als een algemene verbindingsfout. Upgrade de workspace naar Pro en probeer het opnieuw in de app.
"The API and agent access are not on your plan." — Een token aanmaken of op Goedkeuren klikken bij een agent-verzoek buiten Pro. Upgrade naar Pro. Weigeren werkt nog wel.
"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." — Een vergrendelde instelling bij Free of Starter. Upgrade naar Pro.
workspace "(plan doesn’t include connected apps)" / "This workspace’s plan does not include connected apps." — Claude of ChatGPT koppelen aan een workspace zonder Pro. Upgrade, of kies een andere workspace in het koppelingsscherm.
Geheim opnieuw genereren opent het upgrade-dialoogvenster — Geheimen kunnen niet worden gegenereerd zonder Pro. Upgrade naar Pro of trek het token in.
"Webhooks are not on your plan." — Testgebeurtenis verzenden of Opnieuw afleveren zonder Pro. Er wordt niets verzonden; wachtende retries eindigen als mislukt met plan_locked. Upgrade naar Pro.
"Your plan does not include paid agent work. Upgrade to let agents start it." plan_locked Betaald werk op een abonnement zonder deze functie. Upgrade naar Pro.

Het token heeft geen toestemming voor

Bericht Code Oorzaak Oplossing
"This token lacks the ability ability. Ask the workspace member who owns it for a token that has it." forbidden_ability Het token heeft niet de machtiging die deze aanroep nodig heeft. Maak een token aan met die machtiging. Zie Agent-machtigingen.
"The token owner's current role in this workspace does not allow ability." forbidden_role De rol van de eigenaar is gewijzigd sinds het token is aangemaakt. Het token toont Overschrijdt rol. Laat iemand met de juiste rol het token aanmaken.
"Your role can’t grant some of these abilities." / "Your role can’t grant: abilities." — Een token aanmaken met machtigingen die je eigen rol overstijgen. Vink ze uit of vraag het aan een eigenaar of beheerder.
"You can't do this in this workspace." forbidden De rol of toegang van de eigenaar staat deze actie op dit item niet toe. Controleer de rol van de eigenaar en de toegang tot de collectie.
"The token owner can view this article but not edit it (collection access)." forbidden_item Het item staat in een collectie die de eigenaar alleen kan bekijken. Geef de eigenaar bewerkingsrechten voor de collectie.
"No item with that id in this token's scope. List or search first and use a returned id." not_found Verkeerde id, of het item valt buiten de sites van het token of de toegang van de eigenaar. Gebruik de lijst- of zoekfunctie en gebruik daarna een geretourneerde id.
"This content is live on a published site, so changing it needs the site:publish ability." live_content_needs_publish Een live documentatie-artikel bewerken (of vertalen) zonder publicatierechten. Geef het token site:publish, of laat het indienen ter beoordeling.
"This article is also shown on a site this token cannot change. …" shared_outside_scope Het artikel verschijnt op een site buiten de sites van het token. Gebruik een token dat alle sites dekt waarop het verschijnt, of laat een beoordelingsnotitie achter.
"This site is paused or offline and read-only. A workspace owner can re-activate it in Docs." site_paused De documentatiesite is gepauzeerd. Heractiveer de site.
Bericht Code Oorzaak Oplossing
"This would pass the token's spend cap. A workspace admin can raise it." cap_exceeded De offerte past niet binnen de limiet Per taak, Per dag of Per maand van het token. Wacht tot de volgende dag of maand, of maak een token aan met hogere limieten.
Een bericht over oprakende credits insufficient_credits De workspace heeft onvoldoende credits. Koop credits of wacht op de toewijzing.
"Your workspace cannot spend credits right now." plan_locked Facturering blokkeert uitgaven, bijvoorbeeld omdat er een betaling openstaat. Controleer Facturering.
"This quote has expired. Ask for a new quote." quote_expired Offertes zijn 15 minuten geldig. Vraag een nieuwe offerte aan.
"This quote was already used. Ask for a new quote." quote_used Een offerte start één taak. Vraag een nieuwe offerte aan.
"This quote is for another kind of job." quote_mismatch Een video-offerte werd bijvoorbeeld gebruikt om een clip te starten. Gebruik de bijbehorende start-aanroep.
"Another start is being checked. Try again in a moment." busy Twee starts op hetzelfde moment. Probeer het na een seconde opnieuw.
De taak wacht met needs_input — Het wacht op goedkeuring bij Agent-verzoeken. Een eigenaar of beheerder keurt het binnen 24 uur goed of weigert het.
De taak eindigt expired — Niemand heeft binnen 24 uur beslist. Start opnieuw en keur het goed.
"This job can no longer be canceled." not_cancelable De taak is al voltooid of kan niet meer worden geannuleerd. —

Veelvoorkomende invoerberichten bij het aanvragen van video's: "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."

Te veel verzoeken

Bericht Code Limiet
"This token is over its request rate. Wait and retry." rate_limited 300 verzoeken per minuut per token
"This workspace is over its agent request rate. Wait and retry." rate_limited 1.200 per minuut per workspace
"Too many writes from this token. Wait and retry." rate_limited 60 schrijfacties per minuut per token
"This token reached its daily write limit. Try again tomorrow." rate_limited 2.000 schrijfacties per dag per token
"This token reached its hourly publish limit. Try again later." rate_limited 10 publicaties per uur per token
"Too many uploads from this token. Wait and retry." rate_limited 30 uploads per minuut
"This token reached its daily upload volume. Try again tomorrow." rate_limited 500 MB per dag per token
"Writes from this token are paused after an unusual burst of changes. The workspace owner was notified." rate_limited Ongebruikelijke activiteit: schrijfacties worden 10 minuten gepauzeerd
"Too many requests. Wait and retry." rate_limited 60 per minuut per IP-adres zonder geldig token

Betaalde starts zijn ook beperkt tot 20 per uur per token en 100 per dag per workspace. Elke 429 heeft een Retry-After header; wacht zo lang.

Inhoud en retries

Bericht Code Oplossing
"The content changed since you read it. Re-read it …, merge your change and retry with that id." revision_conflict De agent leest de pagina opnieuw en past de wijziging opnieuw toe.
"This idempotency key was used for a different request." idempotency_conflict / idempotency_key_reused Gebruik een Nieuw token Idempotency-Key voor een nieuw verzoek.
— idempotency_in_progress Het eerste verzoek met deze sleutel loopt nog. Wacht en probeer het opnieuw met dezelfde sleutel.

Tokens en de pagina

Situatie Oorzaak Oplossing
Nieuw token is uitgeschakeld "Your workspace has reached its limit of 50 active tokens. Revoke one first." Trek een token in dat je niet gebruikt.
Geen Geheim opnieuw genereren optie Alleen de maker van het token kan het opnieuw genereren, en slechts één keer. "Only the person who created this token can regenerate it. You can revoke it." Genereer het nieuwere token opnieuw, of maak er een aan.
"This token was already regenerated, revoked or has expired; use its replacement or create a new one." Het geheim is al eerder opnieuw gegenereerd. Gebruik het vervangende token.
Je ziet het token van een collega niet Alleen eigenaren en beheerders zien elk token. Vraag het aan een eigenaar of beheerder.
Je kunt een verzoek niet goedkeuren: "An owner or admin decides" Alleen eigenaren en beheerders keuren uitgaven goed. Vraag het aan een eigenaar of beheerder.
"Only owners and admins manage webhooks" Jouw rol kan geen webhooks beheren. Vraag het aan een eigenaar of beheerder.

Claude of ChatGPT verbinden

Op het scherm Oplossing
"This request expired" "Too much time passed since the app asked. Start connecting again from the app."
"This app isn’t registered" Verwijder de connector in de app en voeg deze opnieuw toe.
"This request can’t be trusted" "Nothing was shared. Start connecting again from the app." Verbind niet als dit blijft gebeuren.
"Choose a workspace you are a member of." Kies een van je workspaces.
"Revoked: token reuse detected" op een verbonden app De aanmelding van de app werd opnieuw gebruikt, dus Clevera heeft deze ingetrokken. Verbind de app opnieuw.

Nog steeds vastgelopen

Neem contact op met support met de request_id uit de foutmelding, de naam van het token (nooit het token zelf) en het tijdstip van de aanroep.

API-tokens beherenWaarom een token niet meer werkt.Agent-machtigingenWelke machtiging een aanroep nodig heeft.Agent-uitgaven en goedkeuringen beherenLimieten, quota en goedkeuringen.De REST API gebruikenFoutindeling en snelheidslimieten.