POST /generations/from-template

Generate content from an existing Gamma template with variable substitution.

Start an asynchronous generation from an existing Gamma template. Use this when you want to keep a fixed layout and swap in new content.

Create generation from template

post

Creates an asynchronous generation job from a template Gamma with variable substitution.

Authorizations

api-key

X-API-KEYstringRequired

API key for authentication

Body

application/json

promptstring · min: 1 · max: 400000Required

Text prompt describing the content to generate from the template. Max 400,000 characters.

Example: Q3 financial summary for investors

gammaIdstringRequired

File ID of the template Gamma. The template must have exactly one Page.

Example: gamma_abc123

themeIdstringOptional

Theme ID to apply. Get available IDs from the GET /themes endpoint.

Example: theme_xyz789

folderIdsstring[] · max: 10Optional

Folder IDs to place the generated Gamma in. Get available IDs from the GET /folders endpoint.

Example: ["folder_abc"]

exportAsstring · enumOptional

Auto-export format after generation completes.

Example: pdfPossible values:

Responses

200

Generation job created successfully

application/json

generationIdstringRequired

Generation job identifier for status polling

Example: gen_xyz789

warningsstringOptional

Warnings about request processing

Example: Some template variables were not found

201Success

application/json

400

Invalid request or template not found

401

Invalid or missing API key

402

Insufficient credits

403

Feature not enabled for workspace

post

/v1.0/generations/from-template

HTTPcURLJavaScriptPython

POST /v1.0/generations/from-template HTTP/1.1
Host: public-api.gamma.app
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 350

{
  "prompt": "Q3 financial summary for investors",
  "gammaId": "gamma_abc123",
  "themeId": "theme_xyz789",
  "imageOptions": {
    "model": "flux-kontext-fast",
    "style": "photorealistic"
  },
  "sharingOptions": {
    "workspaceAccess": "view",
    "externalAccess": "noAccess",
    "emailOptions": {
      "recipients": [
        "[email protected]"
      ],
      "access": "view"
    }
  },
  "folderIds": [
    "folder_abc"
  ],
  "exportAs": "pdf"
}

{
  "generationId": "gen_xyz789",
  "warnings": "Some template variables were not found"
}

For template workflow guidance, see Generate from template.

Related

• Generate from template for workflow and parameter guidance

• GET /generations/{id} for the polling step after creation