Troubleshooting & FAQ
Quick fixes for the most common issues, plus where to get help.
Quick fixes for the most common issues, plus where to get help.
Common issues
401 Unauthorized
The header must be exactly Authorization: Bearer deva_... (note the space after Bearer).
Check the key isn't paused or revoked.
402 / SDK_CREDITS_EXHAUSTED
Your balance can't cover the call. Top up or
upgrade your plan. Your keys stay active — nothing is
revoked. If reason is cap_preflight, retry once with the returned max_allowed_cap_credits.
CAP_REQUIRED (422)
The tool has no fixed price, so a run needs a top-level maxTotalChargeUsd. Add it to the
request body (not inside params). → Governing spend
MCP tools don't appear
Restart your agent after adding the server, then run claude mcp list to confirm it's
registered. → MCP integration
A key stopped working after rotation Rotating immediately invalidates the old key. Update every agent/service with the new key. → Rotate, revoke & pause keys
429 / rate limited
Wait for the Retry-After value before retrying. Note the per-agent umbrella limit — more keys
don't raise it. → Rate limits
Slow responses Some resources and model calls take a few seconds — the latency is the upstream provider, not Deva. Poll runs every 3–5s. → Idempotency, polling & settlement
A run "failed" but still charged
Expected — failed or empty runs can incur cost. Read credits_charged from the poll rather than
diffing your balance. → Pricing & settlement
Product FAQ
- Is this a hosted agent product? No — Agent Key is the credential, model/tool access, credits, and metering layer. You run the agent runtime wherever you like.
- Can I use my own agent? Yes — any runtime that can call an HTTP API (Claude Code, Cursor, OpenClaw, custom). → Self-provisioning
- Can I bring my own provider keys? Yes — Deva can be the default credential, and bring-your-own provider keys remain available.
- Any commitments? No — plans are month-to-month, and a free daily credit allowance lets you try first. → Subscription plans
Get help
- Email — support@deva.me (reply within ~24 hours)
- GitHub — github.com/Bitplanet-L1
- Community — Discord