> For the complete documentation index, see [llms.txt](https://developers.gamma.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.gamma.app/reference/common-feature-requests.md).

# API scope and limits

What the Gamma API and MCP server cover today — generate, edit, read, export, and analyze gammas — and the limits to design around.

The Gamma API and the hosted MCP server let your code or your AI agent generate new gammas, edit existing ones, read their content and comments, export them to PDF, PPTX, or PNG, and read engagement analytics. This page is the one-screen map of that surface and the limits to design around.

### Quick reference

* Generate new presentations, documents, and social posts with the Gamma 5 agent (`POST /agent/generations`, optionally from a template or existing gamma via `templateId`). This is the recommended path for new integrations. The Classic endpoints (`POST /generations`, `POST /generations/from-template`) run the previous engine, remain available for existing integrations, and are the way to generate webpages and multi-page gammas or sites.
* Edit an existing gamma: `POST /agent/gammas/{gammaId}/edits` applies a natural-language instruction to a gamma you can edit. The MCP server exposes the same capability as `edit_gamma`.
* Read existing gammas: metadata, full-text search, comment threads, and analytics. The MCP `read_gamma` tool returns a gamma's content.
* Export any gamma in your workspace that you can view, not just ones the API created (`POST /gammas/{gammaId}/export`). Gammas from other workspaces and archived gammas can't be exported.
* Everything that generates, edits, or exports is asynchronous: create the job, then poll until `completed` or `failed`. There are no webhooks.
* Export URLs are temporary -- download files promptly.
* Image URLs in your input must be publicly accessible.
* Archiving does not deduct credits. Deletion is available to workspace admins.
* Submit feature requests on our [Canny board](https://meetgamma.canny.io).

### What the API covers

| Capability                                                                  | Endpoint                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | MCP tool                                                                                                             |
| --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Generate (Gamma 5, recommended)**                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                      |
| Generate with the Gamma agent, optionally from a template or existing gamma | [`POST /agent/generations`](https://developers.gamma.app/agent-gamma-5/create-agent-generation.md)                                                                                                                                                                                                                                                                                                                                                                                                      | `generate`; `generate_from_template` (workspace templates only)                                                      |
| **Generate (Classic)**                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                      |
| Generate a gamma from text                                                  | [`POST /generations`](https://developers.gamma.app/generations-classic/create-generation.md)                                                                                                                                                                                                                                                                                                                                                                                                            | --                                                                                                                   |
| Generate from a workspace template                                          | [`POST /generations/from-template`](https://developers.gamma.app/generations-classic/create-from-template.md)                                                                                                                                                                                                                                                                                                                                                                                           | --                                                                                                                   |
| Generate a multi-page gamma                                                 | [`POST /generations`](https://developers.gamma.app/generations-classic/create-generation.md) with `pages`                                                                                                                                                                                                                                                                                                                                                                                               | `generate_multi_page_gamma`                                                                                          |
| **Images**                                                                  |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                      |
| Generate a standalone image                                                 | [`POST /images`](https://developers.gamma.app/images/create-image-generation.md)                                                                                                                                                                                                                                                                                                                                                                                                                        | `generate_image`                                                                                                     |
| **Check job status**                                                        |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                      |
| Poll a generation, edit, image, or export job                               | [`GET /generations/{id}`](https://developers.gamma.app/generations-classic/get-generation-status.md), [`GET /agent/generations/{generationId}`](https://developers.gamma.app/agent-gamma-5/get-agent-generation-status.md), [`GET /agent/edits/{editId}`](https://developers.gamma.app/agent-gamma-5/get-edit-status.md), [`GET /images/{id}`](https://developers.gamma.app/images/get-image-generation-status.md), [`GET /exports/{id}`](https://developers.gamma.app/management/get-export-status.md) | `get_*_status`                                                                                                       |
| **Edit**                                                                    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                      |
| Edit an existing gamma                                                      | [`POST /agent/gammas/{gammaId}/edits`](https://developers.gamma.app/agent-gamma-5/edit-gamma.md)                                                                                                                                                                                                                                                                                                                                                                                                        | `edit_gamma`                                                                                                         |
| **Read and manage**                                                         |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                      |
| Get gamma metadata                                                          | [`GET /gammas/{gammaId}`](https://developers.gamma.app/management/get-gamma.md)                                                                                                                                                                                                                                                                                                                                                                                                                         | `read_gamma` (content); `get_gammas` to list                                                                         |
| Read a gamma's content                                                      | --                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | `read_gamma`                                                                                                         |
| Search gammas by content                                                    | [`GET /gammas/search`](https://developers.gamma.app/management/search-gammas.md)                                                                                                                                                                                                                                                                                                                                                                                                                        | `search_gammas`                                                                                                      |
| Search workspace and explore templates                                      | [`GET /templates/search`](https://developers.gamma.app/management/search-templates.md)                                                                                                                                                                                                                                                                                                                                                                                                                  | `search_templates`                                                                                                   |
| List comment threads                                                        | [`GET /gammas/{gammaId}/comments`](https://developers.gamma.app/management/get-gamma-comments.md)                                                                                                                                                                                                                                                                                                                                                                                                       | `get_gamma_comments`                                                                                                 |
| List themes and folders                                                     | [`GET /themes`](https://developers.gamma.app/workspace/list-themes.md), [`GET /folders`](https://developers.gamma.app/workspace/list-folders.md)                                                                                                                                                                                                                                                                                                                                                        | `get_themes`, `get_folders`                                                                                          |
| Export to PDF, PPTX, or PNG                                                 | [`POST /gammas/{gammaId}/export`](https://developers.gamma.app/management/export-gamma.md)                                                                                                                                                                                                                                                                                                                                                                                                              | `export_gamma`                                                                                                       |
| Archive a gamma or a media library image                                    | [`POST /gammas/{gammaId}/archive`](https://developers.gamma.app/management/archive-gamma.md), [`POST /images/media/{savedMediaId}/archive`](https://developers.gamma.app/images/archive-image.md)                                                                                                                                                                                                                                                                                                       | --                                                                                                                   |
| Delete a gamma                                                              | [`DELETE /gammas/{gammaId}`](https://developers.gamma.app/management/delete-gamma.md)                                                                                                                                                                                                                                                                                                                                                                                                                   | --                                                                                                                   |
| **Analytics**                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                      |
| Gamma, per-card, and per-viewer engagement                                  | [`GET /gammas/{gammaId}/analytics`](https://developers.gamma.app/analytics/get-gamma-analytics.md), [`.../analytics/cards`](https://developers.gamma.app/analytics/get-gamma-card-analytics.md), [`.../analytics/viewers`](https://developers.gamma.app/analytics/get-gamma-viewer-analytics.md), [`.../analytics/viewers/{userId}`](https://developers.gamma.app/analytics/get-gamma-viewer-detail-analytics.md)                                                                                       | `get_gamma_analytics`, `get_gamma_card_analytics`, `get_gamma_viewer_analytics`, `get_gamma_viewer_detail_analytics` |

See the [MCP tools reference](https://developers.gamma.app/mcp/mcp-tools-reference.md) for tool parameters and [Set up the MCP server](https://developers.gamma.app/mcp/gamma-mcp-server.md) for how to connect.

### Limits to design around

**Editing.** Pass a file id to target the gamma's main page, or a page id from a docs URL to target that page. The edit changes the target page unless the prompt names another page by title or position. When the prompt asks, an edit can add, duplicate, reorder, rename, and archive pages (it never archives the target page). The caller needs edit access to the gamma, archived gammas cannot be edited, and only one edit runs on a gamma at a time. Edits are prompt-directed: you describe the change in natural language and Gamma applies it. There is no object-level API for addressing a specific slide element.

**Templates.** `POST /generations/from-template` and `generate_from_template` accept gammas in your workspace that are marked as templates. The template must be single-page, with a card count within your plan's card limit; non-template, archived, multi-page, and site-bound gammas are rejected when you submit the request. Official Explore templates from `GET /templates/search` are not accepted as `gammaId`, but are accepted as `templateId` on the agent endpoint. The template's structure is preserved by default and changes only when your prompt asks for it. See [Generate from template](https://developers.gamma.app/guides/create-from-template-api-parameters-explained.md). The agent endpoint is broader: `POST /agent/generations` takes an optional `templateId` naming a workspace template, an existing gamma in the workspace, or an official Explore template, and the prompt decides how that source is used.

**Charts and structured content.** Charts, tables, and infographics can be prompted for, but there are no parameters that control chart type, styling, or data formatting, and results vary across runs. For predictable layouts, build them into a template. See [Charts and structured content](https://developers.gamma.app/guides/charts-and-structured-content.md).

**Exports.** A completed generation includes an `exportUrl` when you set `exportAs`; any other gamma in your workspace that you can view can be exported with `POST /gammas/{gammaId}/export` (archived gammas can't). `pdf` and `pptx` download directly; `png` returns a `.zip` with one PNG per card. Export URLs expire after approximately one week, and anyone with the link can download the file until then -- treat them as secrets.

**Your own images.** On the Classic endpoints, include image URLs in `inputText` (`POST /generations`) or `prompt` (`POST /generations/from-template`); Gamma fetches and re-hosts them. See [Image URL best practices](https://developers.gamma.app/guides/image-url-best-practices.md) for URL requirements. `POST /agent/generations` doesn't guarantee that URLs in `prompt` are fetched and re-hosted.

**Waiting for results.** Poll the matching status endpoint every few seconds. See [Poll for results](https://developers.gamma.app/guides/async-patterns-and-polling.md) for implementation patterns.

### Related

* [Explore the API](https://developers.gamma.app/get-started/understanding-the-api-options.md) for how the endpoints fit together
* [MCP tools reference](https://developers.gamma.app/mcp/mcp-tools-reference.md) for the same capabilities as MCP tools
* [Generate from template](https://developers.gamma.app/guides/create-from-template-api-parameters-explained.md) for the template workflow
* [Get Help](https://developers.gamma.app/reference/get-help.md) for support channels


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.gamma.app/reference/common-feature-requests.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
