Skip to content
juicebox-incident-runbook logo

Juicebox Incident Runbook

juicebox-incident-runbook

Juicebox incident response.

SKILL.md

Full skill instructions

Juicebox Incident Runbook

Overview

Incident response procedures for Juicebox AI analysis platform integration failures. Covers analysis timeouts, dataset corruption, quota exhaustion, and export failures. Juicebox powers AI-driven people search and candidate analysis, so incidents disrupt recruiting pipelines, talent intelligence workflows, and automated sourcing. Classify severity immediately using the matrix below and follow the corresponding playbook.

Severity Levels

LevelDefinitionResponse TimeExample
P1 - CriticalFull API outage or dataset corruption15 minHealth endpoint returns 5xx, analysis results missing
P2 - HighAnalysis timeouts or export failures30 minSearch queries hang beyond 30s, CSV exports fail
P3 - MediumQuota exhaustion or rate limiting2 hours429 responses, account quota at 100% usage
P4 - LowPartial data or degraded result quality8 hoursSearch returns fewer results than expected

Diagnostic Steps

# Check API health
curl -s -o /​dev/​null -w "HTTP %{http_code}\n" \
  -H "Authorization: Bearer $JUICEBOX_API_KEY" \
  https://api.juicebox.ai/​v1/​health

# Check account quota usage
curl -s -H "Authorization: Bearer $JUICEBOX_API_KEY" \
  https://api.juicebox.ai/​v1/​account/​quota | jq '.used, .limit, .remaining'

# Test a minimal search request
curl -s -w "\nHTTP %{http_code}\n" \
  -H "Authorization: Bearer $JUICEBOX_API_KEY" \
  -H "Content-Type: application/​json" \
  -X POST https://api.juicebox.ai/​v1/​search \
  -d '{"query": "software engineer", "limit": 1}'

Incident Playbooks

API Outage

  1. Confirm via health endpoint and status.juicebox.ai
  2. Activate fallback mode — serve cached search results to active users
  3. Pause any automated sourcing pipelines to avoid wasting quota on retries
  4. Notify recruiting team that live search is temporarily unavailable
  5. Monitor status page and resume operations once health check passes

Authentication Failure

  1. Verify API key is set: echo $JUICEBOX_API_KEY | wc -c
  2. Test with health endpoint (see diagnostics above)
  3. If 401: API key may be revoked — regenerate in Juicebox dashboard
  4. If 403: check account tier permissions for the requested endpoint
  5. Deploy new key and verify search requests succeed

Data Sync Failure

  1. Check if recent analysis results are returning stale or incomplete data
  2. Verify export endpoints are responding — test a small CSV export
  3. If exports fail: check if the analysis job completed successfully first
  4. For dataset corruption: re-trigger the analysis with fresh parameters
  5. Contact Juicebox support with job IDs and error responses

Communication Template

**Incident**: Juicebox Integration [Outage/​Degradation]
**Status**: [Investigating/​Identified/​Mitigating/​Resolved]
**Started**: YYYY-MM-DD HH:MM UTC
**Impact**: [Search unavailable / exports failing / quota exhausted / N recruiting workflows paused]
**Current action**: [Cached results active / quota upgrade requested / re-analysis running]
**Next update**: HH:MM UTC

Post-Incident

  • Document timeline from detection to resolution
  • Identify root cause (Juicebox outage / quota burn / export bug / auth expiry)
  • Calculate impact: missed candidates, paused pipelines, stale data duration
  • Add quota usage alerting at 80% threshold to prevent exhaustion
  • Implement request caching to reduce redundant API calls
  • Review automated pipeline frequency to avoid quota spikes

Error Handling

Incident TypeDetectionResolution
Analysis timeoutRequests exceeding 30s SLAReduce query complexity, retry with smaller scope
Dataset corruptionMissing or inconsistent analysis resultsRe-trigger analysis job, verify input parameters
Quota exhaustion429 responses, quota endpoint shows 0 remainingPause automation, request quota increase, optimize usage
Export failureCSV/​JSON export returns error or empty payloadVerify analysis job completed, retry export with job ID

Resources

  • Juicebox Status
  • Juicebox API Docs

Next Steps

See juicebox-observability for monitoring setup and quota tracking dashboards.

More skills from jeremylongshore

openrouter-compliance-review logo
jeremylongshore/claude-code-plugins-plus-skills

openrouter-compliance-review

Review OpenRouter integration for regulatory compliance (SOC2, GDPR,

2.8K 0
View
maintainx-data-handling logo
jeremylongshore/claude-code-plugins-plus-skills

maintainx-data-handling

Data synchronization, ETL patterns, and data management for MaintainX.

2.8K 0
View
groq-core-workflow-a logo
jeremylongshore/claude-code-plugins-plus-skills

groq-core-workflow-a

Execute Groq primary workflow: chat completions with tool use and JSON

2.8K 0
View
validating-csrf-protection logo
jeremylongshore/claude-code-plugins-plus-skills

validating-csrf-protection

Validate CSRF protection implementations for security gaps. Use when

2.8K 0
View
api-contract logo
jeremylongshore/claude-code-plugins-plus-skills

api-contract

Configure this skill should be used when the user asks about "API contract",

2.8K 0
View
ideogram-incident-runbook logo
jeremylongshore/claude-code-plugins-plus-skills

ideogram-incident-runbook

Execute Ideogram incident response with triage, mitigation, and postmortem.

2.8K 0
View
gamma-sdk-patterns logo
jeremylongshore/claude-code-plugins-plus-skills

gamma-sdk-patterns

Reusable patterns for the Gamma REST API (no SDK exists).

2.8K 0
View
deepgram-sdk-patterns logo
jeremylongshore/claude-code-plugins-plus-skills

deepgram-sdk-patterns

Apply production-ready Deepgram SDK patterns for TypeScript and Python.

2.8K 0
View
openrouter-upgrade-migration logo
jeremylongshore/claude-code-plugins-plus-skills

openrouter-upgrade-migration

Migrate to OpenRouter from direct provider APIs or upgrade between SDK/model

2.8K 0
View
openrouter-common-errors logo
jeremylongshore/claude-code-plugins-plus-skills

openrouter-common-errors

Diagnose and fix common OpenRouter API errors. Use when encountering

2.8K 0
View
linear-cost-tuning logo
jeremylongshore/claude-code-plugins-plus-skills

linear-cost-tuning

Optimize Linear API usage, reduce unnecessary calls, and maximize

2.8K 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View