fireflies-incident-runbook

# Fireflies.ai Incident Runbook ## Overview Rapid incident response procedures for Fireflies.ai integration failures. Covers API outages, authentication problems, webhook issues, and rate limiting. ## Severity Levels | Level | Definition | Response Time | Examples | |-------|------------|---------------|----------| | P1 | Integration fully broken | < 15 min | `auth_failed` on all requests | | P2 | Degraded functionality | < 1 hour | Rate limiting, slow responses | | P3 | Minor impact | < 4 hours | Webhook delays, missing summaries | | P4 | No user impact | Next business day | Monitoring gaps | ## Quick Triage (Run First) ```bash set -euo pipefail echo "=== Fireflies.ai Incident Triage ===" echo "" # 1. Can we reach the API? echo "--- API Connectivity ---" curl -s -o /dev/null -w "HTTP %{http_code} (%{time_total}s)\n" \ -X POST https://api.fireflies.ai/graphql \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "{ user { email } }"}' # 2. What error are we getting? echo "" echo "--- API Response ---" curl -s -X POST https://api.fireflies.ai/graphql \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "{ user { email is_admin } }"}' | jq . # 3. Can we list transcripts? echo "" echo "--- Transcript Access ---" curl -s -X POST https://api.fireflies.ai/graphql \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -H "Content-Type: application/json" \ -d '{"que...