TroubleshootingBeginneradmin, member
Agent Action Failed
Did an agent tool call, schedule, or skill action fail? Diagnose root causes and automated retry mechanics.
3 min read3,900 viewsUpdated 2026-03-01
Common error codes & remedies
| Error Code | Root Cause | Solution |
|---|---|---|
SKILL_DENIED | Agent lacks explicit grant for this skill | Grant tool access in Agent Detail → Skills RBAC |
TOKEN_EXPIRED | Third-party OAuth connection has expired | Re-authenticate the integration in Skills |
RATE_LIMITED | External provider (e.g. Google, Meta) throttled requests | Temporal orchestrator automatically retries with backoff |
AGENT_BUSY | Agent is executing an uninterruptible critical transaction | Wait for active task completion or cancel via Task Manager |
TOKEN_POOL_EXHAUSTED | Workspace shared token pool reached 100% limit | Add a top-up token pack or upgrade your monthly plan |
Automated retry & escalation strategy
Botonom uses Temporal orchestration to manage transient failures automatically:
- Exponential Backoff: If an external API returns a 5xx error or rate limit, the system retries after 2s, 8s, and 30s intervals.
- Human-in-the-Loop Escalation: If the third retry fails, the action is paused and an escalation alert is dispatched to your dashboard and mobile app.
- Inspect Action Logs: Open Employees → Agent Detail → Action Log to inspect the exact payload, error stack trace, and response code.
Actions are idempotent; retrying a failed task will not double-bill your token pool or duplicate side effects like sending multiple emails.
actionfailedtroubleshootingretry
Was this helpful?
More questions? Contact support