Skip to main content
Most AgentKey errors fall into one of five categories: authentication problems, insufficient credits, incorrect tool names, missing or invalid parameters, and upstream provider outages. The table below maps each symptom to its likely cause and the fastest path to resolution. Work through the relevant row before opening a support ticket.
SymptomCauseResolution
401 / unauthorizedMissing, revoked, or misconfigured master keyRe-create your ak_... key in the console and re-run the installer or skill setup — see Authentication
Out-of-credits errorCredit balance exhaustedTop up your balance in the console — see Pay-as-you-go
Unknown tool / fuzzy suggestions returnedTool name typo or guessed nameRe-run find_tools with the full intent, or read the fuzzy-match suggestions returned by describe_tool and correct the name
Missing / invalid parameter errordescribe_tool step was skippedAlways call describe_tool before every execute_tool call and copy the execute_as template exactly
Provider unavailableUpstream provider outageAgentKey automatically fails over to a healthy provider where possible — see Auto Failover. If the error persists, wait and retry
When you are unsure whether the problem is your balance, your key, or an upstream provider, run the free account tool first. A single execute_tool("agentkey_account") call shows your remaining credit balance and the live health status of every provider category — and it never costs you any credits.