Gamma Tools

Gamma is an AI-powered content creation platform for building presentations, documents, webpages, and social posts. Use these tools in a workflow to programmatically generate polished content from plain text, clone and adapt templates, check async generation status, and look up available workspace themes and folders.

Overview

Operations

Configuration

gamma_generate

POST https://public-api.gamma.app/v1.0/generations

gamma_generate_from_template

POST https://public-api.gamma.app/v1.0/generations/from-template

gamma_check_status

GET https://public-api.gamma.app/v1.0/generations/{generationId}

gamma_list_themes

GET https://public-api.gamma.app/v1.0/themes

gamma_list_folders

GET https://public-api.gamma.app/v1.0/folders

Outputs

gamma_generate

• generationId (string) — The ID of the generation job. Pass this to gamma_check_status to poll for completion.

gamma_generate_from_template

• generationId (string) — The ID of the generation job. Pass this to gamma_check_status to poll for completion.

gamma_check_status

• generationId (string) — The generation ID that was polled.
• status (string) — Current status of the job: pending, completed, or failed.
• gammaUrl (string, optional) — Public URL of the generated Gamma. Present only when status is completed.
• credits (json, optional) — Credit usage information. Contains deducted and remaining fields.
• error (json, optional) — Error details when status is failed. Contains message and statusCode fields.

gamma_list_themes

• themes (array) — List of available theme objects. Each item contains id, name, type, colorKeywords, and toneKeywords.
• hasMore (boolean) — Whether additional pages of results are available.
• nextCursor (string, optional) — Pagination cursor to pass as after in the next request.

gamma_list_folders

• folders (array) — List of available folder objects. Each item contains id and name.
• hasMore (boolean) — Whether additional pages of results are available.
• nextCursor (string, optional) — Pagination cursor to pass as after in the next request.

YAML Example

gamma_1:
  type: gamma
  name: "Gamma"
  inputs:
    operation: "gamma_generate"
    inputText: "{{agent_1.output}}"
    textMode: "generate"
    format: "presentation"
    numCards: 10
    textAmount: "medium"
    imageSource: "aiGenerated"
    apiKey: "{{GAMMA_API_KEY}}"
  connections:
    outgoing:
      - target: gamma_status_1

gamma_status_1:
  type: gamma
  name: "Gamma Check Status"
  inputs:
    operation: "gamma_check_status"
    generationId: "{{gamma_1.generationId}}"
    apiKey: "{{GAMMA_API_KEY}}"
  connections:
    outgoing:
      - target: next-block-id

Tips

• Generation is asynchronous. gamma_generate and gamma_generate_from_template return a generationId immediately, but the Gamma may not be ready yet. Always follow up with gamma_check_status (polling until status is completed) before using gammaUrl downstream.
• Find theme and folder IDs first. Use gamma_list_themes and gamma_list_folders earlier in the workflow to discover valid IDs, then pass those IDs to the generate operations via {{listThemesBlock.themes}} and {{listFoldersBlock.folders}}.
• Card dimensions depend on format. Valid cardDimensions values differ by format: presentations support fluid, 16x9, 4x3; documents support fluid, pageless, letter, a4; social posts support 1x1, 4x5, 9x16. Mismatches may be rejected by the API.