Explore the API

How the Gamma API works, what it can do, and which endpoint to use.

The Gamma API generates polished presentations, documents, websites, and social posts from text. Everything runs asynchronously: you create a generation, poll for status, and retrieve the result.

Use this page to decide which workflow fits your use case. When you need the exact request schema, field types, or response contract, see the individual endpoint reference pages.

How it works

1

Create a generation

POST /v1.0/generations with your content and parameters. You get back a generationId.

2

Poll for status

GET /v1.0/generations/{generationId} every 5 seconds until status is completed or failed.

3

Get your result

The completed response includes gammaUrl (view it in Gamma) and exportUrl (download as PDF, PPTX, or PNG).

See Poll for results for full implementation examples in Python, JavaScript, and cURL.

Quick reference

• Use POST /v1.0/generations when you want Gamma to create the layout from your prompt and parameters.

• Use POST /v1.0/generations/from-template when you already have a Gamma template and want repeated outputs in the same structure.

• Poll GET /v1.0/generations/{generationId} until status is completed or failed.

• Use GET /v1.0/themes and GET /v1.0/folders to look up IDs before generation.

Two ways to generate

	Generate API	Create from Template API
Endpoint	POST /v1.0/generations	POST /v1.0/generations/from-template
When to use	Creating from scratch. Maximum flexibility — you control format, tone, audience, images, layout, and more.	Producing variations of a consistent layout. Design the template once in the Gamma app, then generate new content into it.
Required fields	inputText + textMode	prompt + gammaId
Key difference	AI determines the layout based on your parameters.	Layout stays fixed to your template. Only the content changes.

Both endpoints support themeId, exportAs, sharingOptions, and folderIds. See the full parameter reference for each:

• Generate API Parameters

• Create from Template Parameters

Key parameters at a glance

Parameter	What it controls	Example values
format	Output type	presentation, document, webpage, social
textMode	How input text is interpreted	generate (topic → content), condense (summarize), preserve (keep as-is)
themeId	Brand theme (colors, fonts, logo)	Get IDs from GET /v1.0/themes
numCards	Number of slides/sections	1–75 depending on plan
exportAs	Auto-export on completion	pdf, pptx, png
imageOptions.source	Where images come from	aiGenerated, webFreeToUseCommercially, noImages
textOptions.tone	Writing style	Any string: "professional", "casual", "academic"
textOptions.audience	Who the content is for	Any string: "executives", "new hires", "students"
cardOptions.headerFooter	Logo, page numbers, text	6 positions per card — see Header and Footer Formatting
sharingOptions	Permissions on the generated gamma	Workspace, external link, and email access levels

Supporting endpoints

Endpoint	Purpose
GET /v1.0/themes	List available themes (standard + custom workspace themes). Use the id as themeId.
GET /v1.0/folders	List workspace folders. Use folder id values in folderIds.

Both list endpoints use cursor-based pagination: check hasMore, pass nextCursor as the after query param.

Authentication

All requests require an API key in the X-API-KEY header. Generate your key from Account Settings > API Keys.

curl https://public-api.gamma.app/v1.0/themes \
  -H "X-API-KEY: $GAMMA_API_KEY"

API access requires a Pro, Ultra, Teams, or Business plan. See Access and Pricing for credit costs and plan details.

Not a developer? You can also use Gamma through connectors and integrations — no code required.

Related

• Generate from text for a parameter-by-parameter walkthrough of POST /v1.0/generations

• Generate from a template for the fixed-layout workflow

• Poll for results for complete polling implementations