fireflies-common-errors

# Fireflies.ai Common Errors ## Overview Quick reference for all Fireflies.ai GraphQL API error codes with root causes and fixes. ## Error Response Format All Fireflies errors follow this GraphQL error structure: ```json { "errors": [{ "message": "Human-readable description", "code": "error_code", "friendly": true, "extensions": { "status": 400, "helpUrls": ["https://docs.fireflies.ai/..."] } }] } ``` ## Error Code Reference ### `auth_failed` (401) **Message:** Invalid or missing API key. ```bash # Verify API key is set and valid echo "Key set: ${FIREFLIES_API_KEY:+YES}" # Test authentication set -euo pipefail curl -s -X POST https://api.fireflies.ai/graphql \ -H "Authorization: Bearer $FIREFLIES_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "{ user { email } }"}' | jq . ``` **Fix:** Regenerate API key at app.fireflies.ai > Integrations > Fireflies API. --- ### `too_many_requests` (429) **Message:** Rate limit exceeded. | Plan | Limit | |------|-------| | Free / Pro | 50 requests per day | | Business / Enterprise | 60 requests per minute | **Fix:** Implement exponential backoff. See `fireflies-rate-limits` skill. --- ### `require_ai_credits` (402) **Message:** AskFred operations require AI credits. **Fix:** Visit Fireflies dashboard > Upgrade section to purchase AI credits. Budget for `createAskFredThread` and `continueAskFredThread` calls. --- ### `account_cancelled` (403) **Message:** Subscription inact...