Agent skill · data analytics · jeremylongshore
juicebox-common-errors
Diagnose and fix Juicebox API errors.
Why this skill is useful
Provides specific error handling strategies and recovery patterns for the Juicebox API that the AI wouldn't reliably generate on its own.
What it needs
Requires juicebox account access. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Juicebox Common Errors Overview Juicebox provides AI-powered people search and analysis for recruiting and research workflows. API integrations cover search queries, profile enrichment, dataset operations, and quota management. Common errors include dataset format mismatches when uploading CSVs, analysis timeouts on large candidate pools, and quota exhaustion on free or starter plans. The quota system counts individual profile enrichments separately from search queries, which often surprises new integrators. This reference covers HTTP errors, business logic failures, and recovery strategies for reliable Juicebox integrations. Error Reference Code Message Cause Fix ------ --------- ------- ----- 400 Invalid query format Malformed search query or empty filters Ensure query is non-empty; validate filter field names 401 invalidapikey API key missing or revoked Verify key at app.juicebox.ai > Settings > API 403 quotaexceeded Plan search limit reached Check quota in dashboard; upgrade plan or wait for reset 404 Profile not found Candidate removed or profile unavailable Re-run search to find updated profile data 408 Analysis timeout Complex query exceeded 60s limit Reduce dataset size or narrow search filters 413 Dataset too large Upload exceeds 50MB or 100K row limit Split dataset into smaller chunks before upload 422 Invalid dataset format CSV headers don't match expected schema Use template from Juicebox docs; required: name, title, company 429 Rate limited Exceeded 30 requests/minute Check Retry-After header; implement exponential backoff Error Handler Debugging Guide Authentication Errors Juicebox API keys are passed via Authorization: Bearer header. Keys are scoped per workspace. If you receive 401, verify the key has not been rotated at app.juicebox.ai > Settings. A 403 indicates quota exhaustion, not a permissions issue -- check your plan's remaining searches. Rate Limit Errors The API enforces 30 requests/minute per key. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/juicebox-common-errors