gamma-common-errors

# Gamma Common Errors ## Overview Reference guide for debugging and resolving common Gamma API errors. ## Prerequisites - Active Gamma integration - Access to logs and error messages - Understanding of HTTP status codes ## Error Reference ### Authentication Errors (401/403) ```typescript // Error: Invalid API Key { "error": "unauthorized", "message": "Invalid or expired API key" } ``` **Solutions:** 1. Verify API key in Gamma dashboard 2. Check environment variable is set: `echo $GAMMA_API_KEY` 3. Ensure key hasn't been rotated 4. Check for trailing whitespace in key ### Rate Limit Errors (429) ```typescript // Error: Rate Limited { "error": "rate_limited", "message": "Too many requests", "retry_after": 60 } ``` **Solutions:** 1. Implement exponential backoff 2. Check rate limit headers: `X-RateLimit-Remaining` 3. Upgrade plan for higher limits 4. Queue requests with delays ```typescript async function withRetry(fn: () => Promise<any>, maxRetries = 3) { for (let i = 0; i < maxRetries; i++) { try { return await fn(); } catch (err) { if (err.code === 'rate_limited' && i < maxRetries - 1) { const delay = (err.retryAfter || Math.pow(2, i)) * 1000; # 1000: 1 second in ms await new Promise(r => setTimeout(r, delay)); continue; } throw err; } } } ``` ### Generation Errors (400/500) ```typescript // Error: Generation Failed { "error": "generation_failed", "message": "Unable to generate presenta...