gamma-common-errors

name	gamma-common-errors
description	Debug and resolve common Gamma API errors. Use when encountering authentication failures, rate limits, generation errors, or unexpected API responses. Trigger with phrases like "gamma error", "gamma not working", "gamma API error", "gamma debug", "gamma troubleshoot".
allowed-tools	Read, Write, Edit, Grep
version	1.13.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","gamma","api","debugging","authentication"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

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)

// 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)

// 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

async function withRetry(fn: () => Promise<any>, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await fn();
    } catch (err) {
      if (err.code ===  && i < maxRetries - ) {
         delay = (err. || .(, i)) * ;  # :  second  ms
          ( (r, delay));
        ;
      }
       err;
    }
  }
}