juicebox-common-errors

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

• Juicebox Docs

Next Steps

See juicebox-debug-bundle.