# Gamma ## API Docs - [Gamma Developer Docs](https://developers.gamma.app/readme.md): Build with the Gamma API — generate presentations, documents, websites, and social posts programmatically. - [Explore the API](https://developers.gamma.app/get-started/understanding-the-api-options.md): How the Gamma API works, what it can do, and which endpoint to use. - [Authenticate with OAuth](https://developers.gamma.app/get-started/authenticate-with-oauth.md): Let Gamma users connect their own accounts to your app with the OAuth 2.0 authorization code flow. - [Review access and pricing](https://developers.gamma.app/get-started/access-and-pricing.md): API access requirements, credit-based pricing, and plan details. - [POST /generations](https://developers.gamma.app/generations/create-generation.md): Generate a presentation, document, website, or social post from text. - [POST /generations/from-template](https://developers.gamma.app/generations/create-from-template.md): Adapt, remix, or transform an existing Gamma. The template's structure is preserved by default and changes only when your prompt asks. - [GET /generations/{id}](https://developers.gamma.app/generations/get-generation-status.md): Poll this endpoint until status is completed or failed. - [POST /agent/generations](https://developers.gamma.app/agent/create-agent-generation.md): Start an asynchronous Gamma agent generation from a natural-language prompt. - [GET /agent/generations/{generationId}](https://developers.gamma.app/agent/get-agent-generation-status.md): Poll an agent generation until status is completed or failed. - [POST /agent/gammas/{gammaId}/edits](https://developers.gamma.app/agent/edit-gamma.md): Start an asynchronous AI edit of one page in an existing Gamma. - [GET /agent/edits/{editId}](https://developers.gamma.app/agent/get-edit-status.md): Poll an agent edit job until status is completed or failed. - [POST /images](https://developers.gamma.app/images/create-image-generation.md): Generate a standalone on-brand image from a text prompt. - [GET /images/{id}](https://developers.gamma.app/images/get-image-generation-status.md): Poll this endpoint until status is completed or failed. - [POST /images/media/{savedMediaId}/archive](https://developers.gamma.app/images/archive-image.md): Archive a media library item. Idempotent — archiving an already archived item succeeds. - [GET /themes](https://developers.gamma.app/workspace/list-themes.md): List all themes available in your workspace, including custom themes. - [GET /folders](https://developers.gamma.app/workspace/list-folders.md): List all folders the authenticated user is a member of. - [GET /gammas/search](https://developers.gamma.app/management/search-gammas.md): Full-text search over gammas the caller can access, matched against titles and body text. - [GET /templates/search](https://developers.gamma.app/management/search-templates.md): Search workspace templates and official Gamma explore templates. With a query, workspace hits rank by title and body text relevance and may fall back to last-edited order. - [GET /gammas/{gammaId}](https://developers.gamma.app/management/get-gamma.md): Returns metadata for a single gamma. Accepts a file ID or the doc ID from a gamma.app/docs/... URL. - [GET /gammas/{gammaId}/comments](https://developers.gamma.app/management/get-gamma-comments.md): Returns comment threads on a Gamma, cursor-paginated. Supports an updatedSince filter for efficient delta polling. - [POST /gammas/{gammaId}/archive](https://developers.gamma.app/management/archive-gamma.md): Archive a Gamma document. Idempotent -- archiving an already archived Gamma succeeds. - [POST /gammas/{gammaId}/export](https://developers.gamma.app/management/export-gamma.md): Start an asynchronous export of an existing Gamma to PDF, PPTX, or PNG. - [GET /exports/{id}](https://developers.gamma.app/management/get-export-status.md): Poll this endpoint until export status is completed or failed. - [DELETE /gammas/{gammaId}](https://developers.gamma.app/management/delete-gamma.md): Delete a Gamma document. Requires a workspace admin role on the API key's workspace. - [GET /gammas/{gammaId}/analytics](https://developers.gamma.app/analytics/get-gamma-analytics.md): Returns doc-level engagement metrics for a Gamma: views, unique viewers/editors, card count, last opened time, and a 30-day daily breakdown. - [GET /gammas/{gammaId}/analytics/cards](https://developers.gamma.app/analytics/get-gamma-card-analytics.md): Returns per-card engagement data for a Gamma: card name, position, view time in seconds, and viewer reach as a percentage for every card. - [GET /gammas/{gammaId}/analytics/viewers](https://developers.gamma.app/analytics/get-gamma-viewer-analytics.md): Returns paginated per-viewer engagement data for a Gamma. Requires at least edit permission; manage permission returns all viewers, edit permission returns only the API key owner's row. - [GET /gammas/{gammaId}/analytics/viewers/{userId}](https://developers.gamma.app/analytics/get-gamma-viewer-detail-analytics.md): Returns one viewer's engagement with a Gamma: display name, email, last-opened time, cards viewed, and per-card view time as a percentage of that viewer's total. - [Generate from text](https://developers.gamma.app/guides/generate-api-parameters-explained.md): When to use the Generate endpoint and how to choose the parameters that shape the output. - [Generate from template](https://developers.gamma.app/guides/create-from-template-api-parameters-explained.md): When to use the Create from Template endpoint and how to choose the parameters that control the generated output. - [Poll for results](https://developers.gamma.app/guides/async-patterns-and-polling.md): Understanding how to work with Gamma’s asynchronous API and poll for results - [Use themes and folders](https://developers.gamma.app/guides/list-themes-and-list-folders-apis-explained.md): How to use the themes and folders endpoints to fetch the IDs you need for generation requests. - [Format headers and footers](https://developers.gamma.app/guides/header-and-footer-formatting.md): Detailed guide to customizing headers and footers in Gamma presentations. - [Optimize image URLs](https://developers.gamma.app/guides/image-url-best-practices.md): How to include your own images in API-generated gammas, and how to avoid common issues with broken or missing images. - [Add charts and structured content](https://developers.gamma.app/guides/charts-and-structured-content.md): How to get the best chart, table, and structured visual results from the Gamma API. - [Set up the MCP server](https://developers.gamma.app/mcp/gamma-mcp-server.md): Gamma MCP powers Gamma Connectors and integrations in popular AI tools. - [MCP tools reference](https://developers.gamma.app/mcp/mcp-tools-reference.md): Authentication, tools, parameters, and error handling for the Gamma MCP server. - [Connect integrations](https://developers.gamma.app/connectors/connectors-and-integrations.md): Connect Gamma to your favorite AI tools and automation platforms. - [Add custom MCP connectors](https://developers.gamma.app/connectors/custom-mcp-connectors.md): Bring your own MCP servers into Gamma so workspace members can use your team's tools and data with Gamma Agent. - [Image models](https://developers.gamma.app/reference/image-model-accepted-values.md): When creating AI generated images in your gamma, you can specify which model to use. - [Output languages](https://developers.gamma.app/reference/output-language-accepted-values.md): Specify the output language of your gamma. - [Error codes](https://developers.gamma.app/reference/error-codes.md): Detailed descriptions of API error codes. - [Warnings](https://developers.gamma.app/reference/warnings.md): Understanding warning messages in API responses. - [API scope and limits](https://developers.gamma.app/reference/common-feature-requests.md): What the Gamma API covers today and how to work within its current scope. - [Get help](https://developers.gamma.app/reference/get-help.md): There are several ways to get in touch with us. - [Changelog](https://developers.gamma.app/reference/changelog.md): New updates and improvements to the Gamma API, MCP Server, and integrations. --- # 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 This site has an agentic ask interface you may use to query the documentation dynamically 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/index.md?ask=&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.