Juicebox Common Errors
Error Reference
401 Authentication
{"error": "invalid_api_key"}
Fix: Verify key at app.juicebox.ai > Settings.
403 Plan Limits
{"error": "quota_exceeded"}
Fix: Check quota in dashboard, upgrade plan.
429 Rate Limited
Fix: Check Retry-After header. Implement exponential backoff.
400 Invalid Query
Fix: Ensure query is non-empty, check filter syntax.
404 Profile Not Found
Fix: Profile may be removed. Re-run search.
Quick Diagnostic
curl -s -H "Authorization: Bearer $JUICEBOX_API_KEY" \
https://api.juicebox.ai/v1/health
Resources
Next Steps
See juicebox-debug-bundle.