API scope and limits

What the Gamma API covers today and how to work within its current scope.

The Gamma API focuses on content generation and workspace management. Common use cases that sit outside that scope are covered below with the closest workaround.

Quick reference

• The API creates gammas but does not edit existing ones.
• Generation is asynchronous: create, then poll until complete.
• Export URLs are temporary -- download files promptly.
• Image URLs can be included in inputText but must be publicly accessible.
• Archiving is available and does not deduct credits.
• Deletion is available for workspace admins and automatically archives first if needed.
• Submit feature requests on our Canny board.

What the API covers

Capability	Endpoint
Generate a gamma from text	POST /generations
Generate from an existing template	POST /generations/from-template
Poll generation status and get results	GET /generations/{id}
List available themes	GET /themes
List workspace folders	GET /folders
Archive a gamma	POST /gammas/{gammaId}/archive
Delete a gamma	DELETE /gammas/{gammaId}

The API focuses on generation — each call produces a new, fully styled gamma. All generation is asynchronous: start a generation with POST /generations, then poll for the result with GET /generations/{id}. See Poll for results for the full workflow.

Working outside the current scope

Updating content after generation

The API creates gammas but does not modify existing ones. To update content, generate a new gamma with the revised input.

Waiting for generation to complete

The API uses an asynchronous polling model. After creating a generation, poll GET /generations/{id} until the status is completed or failed. See Poll for results for implementation patterns across platforms.

Exporting files

A completed generation will includes an exportUrl for downloading the output if you supplied exportAs parameter. Format matches exportAs: pdf and pptx download directly; png returns a .zip with one PNG per card. The URL expires after approximately one week. Anyone with the link can download the file until then — access is not tied to your API key, so treat it as a secret.

Providing your own images

You can include image URLs directly in your inputText. Gamma fetches and re-hosts them during generation. See Image URL best practices for URL requirements and troubleshooting.

Generating charts and structured content

Charts, tables, and infographics can be prompted for through your input text. Results vary across runs — for more predictable layouts, use the template-based generation endpoint. See Charts and structured content.

Related

• Generate from text for the full parameter reference
• Poll for results for the polling workflow
• Image URL best practices for including your own images
• Get Help for support channels