# Gamma

> Make presentations, documents, social posts and webpages with Gamma's AI from a brief, a template or your text; edit them by describing the change; export to PDF or PowerPoint; and track comments and views.

App · 23 actions. Web page: https://docs.lodol.com/docs/integrations/gamma

## Actions

### Archive gamma

Archive a gamma so it leaves the workspace's lists without being deleted. You need edit access. Archiving twice is harmless.

**Inputs**

- Gamma (`gamma`, text, required): The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.

**Outputs**

- `archived` (true/false): True once archived
- `gamma_id` (text): The gamma's file id
- `title` (text): The gamma's title

**Example output**

```json
{
  "archived": true,
  "gamma_id": "g_l0mf2jvf1fpmi1v",
  "title": "Q3 product launch plan"
}
```

### Archive image

Remove an image from your Gamma media library. Its link keeps working, and gammas using it are unaffected.

**Inputs**

- Media library ID (`saved_media_id`, text, required): The 'saved_media_id' 'Create image' or 'Get image' returned.

**Outputs**

- `archived` (true/false): True once archived
- `saved_media_id` (text): The image archived

**Example output**

```json
{
  "archived": true,
  "saved_media_id": "media_7h2k"
}
```

### Create gamma

Have the Gamma agent make a presentation, document or social post from a brief, in one of your themes. Waits for it and returns its link, and the download link if you also export it.

**Inputs**

- What to make (`prompt`, text, required): Describe what you want, as you would to a designer: the topic, the points to cover, who it's for. Paste notes or an outline too.
- Format (`format`, text): What to make. Defaults to a presentation. One of: `presentation` (Presentation (default)), `document`, `social` (Social post). Default: `presentation`.
- Number of cards (`num_cards`, number): About how many slides or sections, 1 to 100 (up to 10 on Gamma's Free plan). Leave empty to let Gamma decide. From 1 to 100.
- Theme (`theme_id`, text): The look: colors, fonts and logo. Pick one of your workspace's themes.
- Quality (`quality`, text): How much effort the Gamma agent puts in; higher uses more credits. Leave empty for Gamma's default for your plan. One of: `lite` (Lite (fastest, fewest credits)), `standard`, `max` (Max (Pro plan or higher)).
- Extra instructions (`additional_instructions`, text): Tone, audience, language or style to aim for, up to 5,000 characters.
- Source links (`source_urls`, list): Up to 10 web pages for the agent to read and draw on. A page it can't read is skipped.
- Folder (`folder_id`, text): The Gamma folder to put it in. Leave empty for none.
- Also export as (`export_as`, text): Also make a file to download when it's done. Its link comes back as 'export_url' and works for about a week. One of: `pdf`, `pptx` (PowerPoint (PPTX)), `png` (PNG images (a .zip, one per card)).
- Workspace access (`workspace_access`, text): What your workspace's members can do with it. Leave empty for the workspace default. One of: `noAccess` (No access), `view` (Can view), `comment` (Can comment), `edit` (Can edit), `fullAccess` (Full access).
- Anyone with the link (`external_access`, text): What people outside the workspace with its link can do. Leave empty for the workspace default. One of: `noAccess` (No access), `view` (Can view), `comment` (Can comment), `edit` (Can edit).
- Share with (`share_with_emails`, list): Email addresses to share it with. Gamma emails each one an invitation.
- Their access (`email_access`, text): What the people in 'Share with' can do with it. One of: `view` (Can view), `comment` (Can comment), `edit` (Can edit), `fullAccess` (Full access (workspace members only)).
- Wait for it to finish (`wait`, true/false): On (the default), the step waits and returns the result. Off, it returns the job id at once, to check later with the matching 'Get' action. Default: `true`.

**Outputs**

- `credits_deducted` (number): Credits this job used, once it has finished
- `credits_remaining` (number): Credits left in the workspace
- `error` (text): Why it failed, if it did
- `export_url` (text): The PDF, PPTX or PNG .zip download link, if an export was asked for. Anyone with it can download the file for about a week.
- `gamma_id` (text): The new gamma's id, for later steps
- `gamma_url` (text): The link to open the gamma in Gamma
- `generation_id` (text): The generation's id, for 'Get generation'
- `progress_percent` (number): How far along it is, 0 to 100
- `status` (text): pending, completed or failed
- `summary` (text): The Gamma agent's summary of what it made
- `warnings` (list): Settings Gamma ignored or adjusted

**Example output**

```json
{
  "credits_deducted": 15,
  "credits_remaining": 485,
  "error": "",
  "export_url": "https://exports.gamma.app/example/deck.pdf",
  "gamma_id": "g_l0mf2jvf1fpmi1v",
  "gamma_url": "https://gamma.app/docs/abc123",
  "generation_id": "gen_V1StGXR8Z5jdHi6B",
  "progress_percent": 100,
  "status": "completed",
  "summary": "Created a 5-card launch deck covering goals, timeline, and metrics.",
  "warnings": []
}
```

### Create gamma from template

Have the Gamma agent make a new gamma starting from a template or an existing gamma, keeping its look. Waits for it and returns its link.

**Inputs**

- Template (`template_id`, text, required): What to start from: one of your workspace's templates, a Gamma template, or any gamma (its id or address). It keeps its look and is left unchanged.
- What to make (`prompt`, text, required): The content to put in it, and how closely to follow the template, such as "Keep every card and layout; only replace the content."
- Format (`format`, text): What to make. Defaults to a presentation. One of: `presentation` (Presentation (default)), `document`, `social` (Social post). Default: `presentation`.
- Number of cards (`num_cards`, number): About how many slides or sections, 1 to 100 (up to 10 on Gamma's Free plan). Leave empty to let Gamma decide. From 1 to 100.
- Quality (`quality`, text): How much effort the Gamma agent puts in; higher uses more credits. Leave empty for Gamma's default for your plan. One of: `lite` (Lite (fastest, fewest credits)), `standard`, `max` (Max (Pro plan or higher)).
- Extra instructions (`additional_instructions`, text): Tone, audience, language or style to aim for, up to 5,000 characters.
- Source links (`source_urls`, list): Up to 10 web pages for the agent to read and draw on. A page it can't read is skipped.
- Folder (`folder_id`, text): The Gamma folder to put it in. Leave empty for none.
- Also export as (`export_as`, text): Also make a file to download when it's done. Its link comes back as 'export_url' and works for about a week. One of: `pdf`, `pptx` (PowerPoint (PPTX)), `png` (PNG images (a .zip, one per card)).
- Workspace access (`workspace_access`, text): What your workspace's members can do with it. Leave empty for the workspace default. One of: `noAccess` (No access), `view` (Can view), `comment` (Can comment), `edit` (Can edit), `fullAccess` (Full access).
- Anyone with the link (`external_access`, text): What people outside the workspace with its link can do. Leave empty for the workspace default. One of: `noAccess` (No access), `view` (Can view), `comment` (Can comment), `edit` (Can edit).
- Share with (`share_with_emails`, list): Email addresses to share it with. Gamma emails each one an invitation.
- Their access (`email_access`, text): What the people in 'Share with' can do with it. One of: `view` (Can view), `comment` (Can comment), `edit` (Can edit), `fullAccess` (Full access (workspace members only)).
- Wait for it to finish (`wait`, true/false): On (the default), the step waits and returns the result. Off, it returns the job id at once, to check later with the matching 'Get' action. Default: `true`.

**Outputs**

- `credits_deducted` (number): Credits this job used, once it has finished
- `credits_remaining` (number): Credits left in the workspace
- `error` (text): Why it failed, if it did
- `export_url` (text): The PDF, PPTX or PNG .zip download link, if an export was asked for. Anyone with it can download the file for about a week.
- `gamma_id` (text): The new gamma's id, for later steps
- `gamma_url` (text): The link to open the gamma in Gamma
- `generation_id` (text): The generation's id, for 'Get generation'
- `progress_percent` (number): How far along it is, 0 to 100
- `status` (text): pending, completed or failed
- `summary` (text): The Gamma agent's summary of what it made
- `warnings` (list): Settings Gamma ignored or adjusted

**Example output**

```json
{
  "credits_deducted": 15,
  "credits_remaining": 485,
  "error": "",
  "export_url": "https://exports.gamma.app/example/deck.pdf",
  "gamma_id": "g_l0mf2jvf1fpmi1v",
  "gamma_url": "https://gamma.app/docs/abc123",
  "generation_id": "gen_V1StGXR8Z5jdHi6B",
  "progress_percent": 100,
  "status": "completed",
  "summary": "Created a 5-card launch deck covering goals, timeline, and metrics.",
  "warnings": []
}
```

### Create gamma from text

Turn your text into a presentation, document, social post or webpage, choosing exactly how the text is used, the language, images and card size. Waits for it and returns its link.

**Inputs**

- Text (`input_text`, text, required): Your text: a topic, an outline or the full content. Put a line with --- between parts to split them into cards.
- Use my text to (`text_mode`, text): Expand it, summarize it, or keep it as written. One of: `generate` (Generate: expand it into new content), `condense` (Condense: summarize it), `preserve` (Preserve: keep my text as written).
- Format (`format`, text): What to make. Defaults to a presentation. One of: `presentation` (Presentation (default)), `document`, `social` (Social post), `webpage`. Default: `presentation`.
- Title (`title`, text): The gamma's title. Leave empty to have one written from the content.
- Number of cards (`num_cards`, number): How many slides or sections, 1 to 100 (up to 10 on Gamma's Free plan). Defaults to 10. Ignored when splitting at --- breaks. From 1 to 100.
- Split into cards (`card_split`, text): By the number of cards, or wherever your text has a --- line. One of: `auto` (Automatically, to the number of cards (default)), `inputTextBreaks` (Where my text has --- breaks). Default: `auto`.
- Theme (`theme_id`, text): The look: colors, fonts and logo. Leave empty for the workspace default.
- Extra instructions (`additional_instructions`, text): Tone, audience, language or style to aim for, up to 5,000 characters.
- Text per card (`text_amount`, text): How much text each card has. One of: `brief`, `medium` (Medium (default)), `detailed`, `extensive`. Default: `medium`.
- Tone (`tone`, text): The writing style, such as professional, upbeat or academic.
- Audience (`audience`, text): Who it's for, such as executives or new hires.
- Language (`language`, text): The language to write in. Defaults to English (US). One of: `en` (English (US)), `en-gb` (English (UK)), `en-in` (English (India)), `af` (Afrikaans), `sq` (Albanian), `ar` (Arabic), `ar-sa` (Arabic (Saudi Arabia)), `bn` (Bengali), `bs` (Bosnian), `bg` (Bulgarian), and 57 more. Default: `en`.
- Images (`image_source`, text): Where the pictures come from. One of: `aiGenerated` (AI-generated (default)), `webFreeToUseCommercially` (Web images licensed for commercial use), `webFreeToUse` (Web images licensed for personal use), `webAllImages` (Web images, any licence), `pexels` (Pexels photos), `pictographic` (Pictographic illustrations), `giphy` (Giphy GIFs), `themeAccent` (The theme's accent images), `placeholder` (Placeholders to fill in later), `noImages` (No images). Default: `aiGenerated`.
- Image model (`image_model`, text): The AI model that draws the pictures, with the credits each image costs. Leave empty to let Gamma choose. Only when Images is AI-generated (default). One of: `flux-1-quick` (Flux 1 Quick (standard, 2 credits)), `flux-2-klein` (Flux 2 Fast (standard, 2 credits)), `flux-kontext-fast` (Flux Kontext Fast (standard, 2 credits)), `gpt-image-1-mini-low` (GPT Image Mini Low (standard, 2 credits)), `luma-photon-flash-1` (Luma Photon Flash (standard, 2 credits)), `gpt-image-2-mini` (GPT Image 2 Mini (standard, 5 credits)), `ideogram-v3-turbo` (Ideogram 3 Turbo (standard, 6 credits)), `flux-1-pro` (Flux 1 Pro (standard, 8 credits)), `flux-2-pro` (Flux 2 Pro (standard, 8 credits)), `gpt-image-1-mini-medium` (GPT Image Mini Medium (standard, 8 credits)), and 26 more.
- Image style (`image_style`, text): The look of the AI images, such as "flat line drawings in navy". Only when Images is AI-generated (default).
- Card size (`dimensions`, text): The shape of each card. Leave empty for the format's default. One of: `fluid` (Fluid (default for decks and documents)), `16x9` (16:9), `4x3` (4:3), `pageless`, `letter` (US Letter), `a4`, `1x1` (Square (1:1)), `4x5` (Portrait (4:5, default for social)), `9x16` (Story (9:16)).
- Folder (`folder_id`, text): The Gamma folder to put it in. Leave empty for none.
- Also export as (`export_as`, text): Also make a file to download when it's done. Its link comes back as 'export_url' and works for about a week. One of: `pdf`, `pptx` (PowerPoint (PPTX)), `png` (PNG images (a .zip, one per card)).
- Workspace access (`workspace_access`, text): What your workspace's members can do with it. Leave empty for the workspace default. One of: `noAccess` (No access), `view` (Can view), `comment` (Can comment), `edit` (Can edit), `fullAccess` (Full access).
- Anyone with the link (`external_access`, text): What people outside the workspace with its link can do. Leave empty for the workspace default. One of: `noAccess` (No access), `view` (Can view), `comment` (Can comment), `edit` (Can edit).
- Share with (`share_with_emails`, list): Email addresses to share it with. Gamma emails each one an invitation.
- Their access (`email_access`, text): What the people in 'Share with' can do with it. One of: `view` (Can view), `comment` (Can comment), `edit` (Can edit), `fullAccess` (Full access (workspace members only)).
- Wait for it to finish (`wait`, true/false): On (the default), the step waits and returns the result. Off, it returns the job id at once, to check later with the matching 'Get' action. Default: `true`.

**Outputs**

- `credits_deducted` (number): Credits this job used, once it has finished
- `credits_remaining` (number): Credits left in the workspace
- `error` (text): Why it failed, if it did
- `export_url` (text): The PDF, PPTX or PNG .zip download link, if an export was asked for. Anyone with it can download the file for about a week.
- `gamma_id` (text): The new gamma's id, for later steps
- `gamma_url` (text): The link to open the gamma in Gamma
- `generation_id` (text): The generation's id, for 'Get generation'
- `progress_percent` (number): How far along it is, 0 to 100
- `status` (text): pending, completed or failed
- `summary` (text): The Gamma agent's summary of what it made
- `warnings` (list): Settings Gamma ignored or adjusted

**Example output**

```json
{
  "credits_deducted": 22,
  "credits_remaining": 485,
  "error": "",
  "export_url": "https://exports.gamma.app/example/deck.pdf",
  "gamma_id": "g_l0mf2jvf1fpmi1v",
  "gamma_url": "https://gamma.app/docs/abc123",
  "generation_id": "Xq2kL9pV3mN8",
  "progress_percent": 100,
  "status": "completed",
  "summary": "",
  "warnings": []
}
```

### Create image

Make an on-brand image from a description, saved to your Gamma media library. Waits for it and returns its link.

**Inputs**

- Description (`prompt`, text, required): What the image shows, including any background, such as "a rocket on white". Up to 5,000 characters.
- Style (`image_type`, text): The kind of image. Ignored when reference images are given. One of: `illustration` (Illustration (default)), `photo`, `abstract`, `scene` (Scene (ignores the theme)). Default: `illustration`.
- Shape (`size_preset`, text): The image's shape. One of: `social-square` (Social square (default)), `social-portrait` (Social portrait), `story`, `slide`, `banner`. Default: `social-square`.
- Theme (`theme_id`, text): The brand theme to style it with. Leave empty for the workspace default.
- Reference images (`reference_image_urls`, list): Up to 4 https links to pictures of a person or product to put in the image.
- Wait for it to finish (`wait`, true/false): On (the default), the step waits and returns the result. Off, it returns the job id at once, to check later with the matching 'Get' action. Default: `true`.

**Outputs**

- `credits_deducted` (number): Credits this job used, once it has finished
- `credits_remaining` (number): Credits left in the workspace
- `error` (text): Why it failed, if it did
- `file_format` (text): png, webp and so on
- `height` (number): Height in pixels
- `image_generation_id` (text): The image job's id, for 'Get image'
- `image_url` (text): The link to the image
- `mime_type` (text): The image's MIME type
- `saved_media_id` (text): The image's id in your Gamma media library
- `status` (text): pending, completed or failed
- `warnings` (list): Settings Gamma ignored or adjusted
- `width` (number): Width in pixels

**Example output**

```json
{
  "credits_deducted": 8,
  "credits_remaining": 477,
  "error": "",
  "file_format": "png",
  "height": 1024,
  "image_generation_id": "img_5d9a",
  "image_url": "https://cdn.gamma.app/example/image.png",
  "mime_type": "image/png",
  "saved_media_id": "media_7h2k",
  "status": "completed",
  "warnings": [],
  "width": 1024
}
```

### Delete gamma

Delete a gamma for good. Only a workspace admin's API key can; 'Archive gamma' works for anyone with edit access.

**Inputs**

- Gamma (`gamma`, text, required): The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.

**Outputs**

- `deleted` (true/false): True once deleted
- `gamma_id` (text): The gamma's file id
- `message` (text): Gamma's confirmation
- `title` (text): The gamma's title

**Example output**

```json
{
  "deleted": true,
  "gamma_id": "g_l0mf2jvf1fpmi1v",
  "message": "The gamma has been deleted.",
  "title": "Q3 product launch plan"
}
```

### Edit gamma

Change a gamma by describing the change, such as "update the pricing card with the new tiers". You need edit access. Waits for it and returns the agent's summary.

**Inputs**

- Gamma (`gamma`, text, required): The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
- Change to make (`prompt`, text, required): What to change, in your own words, up to 10,000 characters.
- Quality (`quality`, text): How much effort the Gamma agent puts in; higher uses more credits. Leave empty for Gamma's default for your plan. One of: `lite` (Lite (fastest, fewest credits)), `standard`, `max` (Max (Pro plan or higher)).
- Wait for it to finish (`wait`, true/false): On (the default), the step waits and returns the result. Off, it returns the job id at once, to check later with the matching 'Get' action. Default: `true`.

**Outputs**

- `credits_deducted` (number): Credits this job used, once it has finished
- `credits_remaining` (number): Credits left in the workspace
- `edit_id` (text): The edit's id, for 'Get edit'
- `error` (text): Why it failed, if it did
- `gamma_id` (text): The edited gamma's id
- `gamma_url` (text): The link to the edited gamma
- `page_id` (text): The page of the gamma that was edited
- `status` (text): pending, completed or failed
- `summary` (text): The Gamma agent's summary of what it changed

**Example output**

```json
{
  "credits_deducted": 4,
  "credits_remaining": 481,
  "edit_id": "edit_8f2kq1",
  "error": "",
  "gamma_id": "g_l0mf2jvf1fpmi1v",
  "gamma_url": "https://gamma.app/docs/abc123",
  "page_id": "abc123",
  "status": "completed",
  "summary": "Changed the Business tier price to $129/mo."
}
```

### Export gamma

Export any gamma you can view to PDF, PowerPoint or PNG images. Waits for the file and returns its download link, which works for about a week.

**Inputs**

- Gamma (`gamma`, text, required): The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
- Export as (`export_as`, text, required): The kind of file. One of: `pdf`, `pptx` (PowerPoint (PPTX)), `png` (PNG images (a .zip, one per card)).
- Wait for it to finish (`wait`, true/false): On (the default), the step waits and returns the result. Off, it returns the job id at once, to check later with the matching 'Get' action. Default: `true`.

**Outputs**

- `error` (text): Why it failed, if it did
- `export_as` (text): pdf, pptx or png
- `export_id` (text): The export's id, for 'Get export'
- `export_url` (text): The download link, once completed. Anyone with it can download the file for about a week.
- `gamma_id` (text): The exported gamma's id
- `status` (text): pending, completed or failed

**Example output**

```json
{
  "error": "",
  "export_as": "pdf",
  "export_id": "exp_3n7c",
  "export_url": "https://exports.gamma.app/example/deck.pdf",
  "gamma_id": "g_l0mf2jvf1fpmi1v",
  "status": "completed"
}
```

### Get card analytics

See, card by card, how long people spent and what share of viewers reached it. Needs a Gamma Pro plan or higher and edit access.

**Inputs**

- Gamma (`gamma`, text, required): The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.

**Outputs**

- `cardCount` (number): Cards in the gamma
- `cards` (list): Every card, in order
- `gammaId` (text): The gamma's file id
- `scope` (text): all (every viewer's activity) or self (only your own)
- `uniqueEditors` (number): Different people who edited it
- `uniqueViewers` (number): Different people who viewed it

**Example output**

```json
{
  "cardCount": 5,
  "cards": [
    {
      "cardId": "card_1",
      "cardName": "Q3 product launch plan",
      "cardPosition": 1,
      "viewTimeSeconds": 320,
      "viewersPercent": 100
    }
  ],
  "gammaId": "g_l0mf2jvf1fpmi1v",
  "scope": "all",
  "uniqueEditors": 2,
  "uniqueViewers": 17
}
```

### Get edit

Check on an edit by the 'edit_id' an 'Edit gamma' step returned.

**Inputs**

- Edit ID (`edit_id`, text, required): The 'edit_id' 'Edit gamma' returned.

**Outputs**

- `credits_deducted` (number): Credits this job used, once it has finished
- `credits_remaining` (number): Credits left in the workspace
- `edit_id` (text): The edit's id, for 'Get edit'
- `error` (text): Why it failed, if it did
- `gamma_id` (text): The edited gamma's id
- `gamma_url` (text): The link to the edited gamma
- `page_id` (text): The page of the gamma that was edited
- `status` (text): pending, completed or failed
- `summary` (text): The Gamma agent's summary of what it changed

**Example output**

```json
{
  "credits_deducted": 4,
  "credits_remaining": 481,
  "edit_id": "edit_8f2kq1",
  "error": "",
  "gamma_id": "g_l0mf2jvf1fpmi1v",
  "gamma_url": "https://gamma.app/docs/abc123",
  "page_id": "abc123",
  "status": "completed",
  "summary": "Changed the Business tier price to $129/mo."
}
```

### Get export

Check on an export by the 'export_id' an 'Export gamma' step returned.

**Inputs**

- Export ID (`export_id`, text, required): The 'export_id' 'Export gamma' returned.

**Outputs**

- `error` (text): Why it failed, if it did
- `export_as` (text): pdf, pptx or png
- `export_id` (text): The export's id, for 'Get export'
- `export_url` (text): The download link, once completed. Anyone with it can download the file for about a week.
- `gamma_id` (text): The exported gamma's id
- `status` (text): pending, completed or failed

**Example output**

```json
{
  "error": "",
  "export_as": "pdf",
  "export_id": "exp_3n7c",
  "export_url": "https://exports.gamma.app/example/deck.pdf",
  "gamma_id": "g_l0mf2jvf1fpmi1v",
  "status": "completed"
}
```

### Get gamma

Get a gamma's title, link, preview image, author, theme and dates, by its id or address.

**Inputs**

- Gamma (`gamma`, text, required): The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.

**Outputs**

- `gamma` (object): The gamma

**Example output**

```json
{
  "gamma": {
    "archived": false,
    "author": {
      "avatarUrl": "",
      "name": "Jo Bloggs"
    },
    "createdTime": "2026-10-20T14:00:00.000Z",
    "description": "Goals, timeline and metrics for the Q3 launch.",
    "id": "g_l0mf2jvf1fpmi1v",
    "themeId": "default-light",
    "thumbnailUrl": "https://cdn.gamma.app/example/thumb.png",
    "title": "Q3 product launch plan",
    "type": "regular",
    "updatedTime": "2026-10-21T09:30:00.000Z",
    "url": "https://gamma.app/docs/Q3-product-launch-plan-abc123"
  }
}
```

### Get gamma analytics

Get a gamma's views, unique viewers and editors, when it was last opened and 30 days of daily viewers. Needs a Gamma Pro plan or higher and edit access.

**Inputs**

- Gamma (`gamma`, text, required): The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.

**Outputs**

- `cardCount` (number): Cards in the gamma
- `dailyViews` (object): Viewers per day over the last 30 days
- `gammaId` (text): The gamma's file id
- `lastOpened` (text): When it was last viewed (ISO 8601)
- `scope` (text): all (every viewer's activity) or self (only your own)
- `totalViews` (number): Times it was opened, counting repeat visits
- `uniqueEditors` (number): Different people who edited it
- `uniqueViewers` (number): Different people who viewed it

**Example output**

```json
{
  "cardCount": 5,
  "dailyViews": {
    "dayCount": 30,
    "days": [
      {
        "date": "2026-10-22",
        "uniqueViewers": 4
      }
    ],
    "timezone": "UTC"
  },
  "gammaId": "g_l0mf2jvf1fpmi1v",
  "lastOpened": "2026-10-22T16:05:00.000Z",
  "scope": "all",
  "totalViews": 42,
  "uniqueEditors": 2,
  "uniqueViewers": 17
}
```

### Get generation

Check on a gamma being made, by the generation id a 'Create gamma' step returned; once done, get its link and download link.

**Inputs**

- Generation ID (`generation_id`, text, required): The 'generation_id' a create step returned.

**Outputs**

- `credits_deducted` (number): Credits this job used, once it has finished
- `credits_remaining` (number): Credits left in the workspace
- `error` (text): Why it failed, if it did
- `export_url` (text): The PDF, PPTX or PNG .zip download link, if an export was asked for. Anyone with it can download the file for about a week.
- `gamma_id` (text): The new gamma's id, for later steps
- `gamma_url` (text): The link to open the gamma in Gamma
- `generation_id` (text): The generation's id, for 'Get generation'
- `progress_percent` (number): How far along it is, 0 to 100
- `status` (text): pending, completed or failed
- `summary` (text): The Gamma agent's summary of what it made
- `warnings` (list): Settings Gamma ignored or adjusted

**Example output**

```json
{
  "credits_deducted": 15,
  "credits_remaining": 485,
  "error": "",
  "export_url": "https://exports.gamma.app/example/deck.pdf",
  "gamma_id": "g_l0mf2jvf1fpmi1v",
  "gamma_url": "https://gamma.app/docs/abc123",
  "generation_id": "gen_V1StGXR8Z5jdHi6B",
  "progress_percent": 100,
  "status": "completed",
  "summary": "Created a 5-card launch deck covering goals, timeline, and metrics.",
  "warnings": []
}
```

### Get image

Check on an image by the 'image_generation_id' a 'Create image' step returned.

**Inputs**

- Image job ID (`image_generation_id`, text, required): The 'image_generation_id' 'Create image' returned.

**Outputs**

- `credits_deducted` (number): Credits this job used, once it has finished
- `credits_remaining` (number): Credits left in the workspace
- `error` (text): Why it failed, if it did
- `file_format` (text): png, webp and so on
- `height` (number): Height in pixels
- `image_generation_id` (text): The image job's id, for 'Get image'
- `image_url` (text): The link to the image
- `mime_type` (text): The image's MIME type
- `saved_media_id` (text): The image's id in your Gamma media library
- `status` (text): pending, completed or failed
- `warnings` (list): Settings Gamma ignored or adjusted
- `width` (number): Width in pixels

**Example output**

```json
{
  "credits_deducted": 8,
  "credits_remaining": 477,
  "error": "",
  "file_format": "png",
  "height": 1024,
  "image_generation_id": "img_5d9a",
  "image_url": "https://cdn.gamma.app/example/image.png",
  "mime_type": "image/png",
  "saved_media_id": "media_7h2k",
  "status": "completed",
  "warnings": [],
  "width": 1024
}
```

### Get viewer analytics

See how one viewer read a gamma: when they last opened it and the share of their time on each card. Needs a Gamma Pro plan or higher.

**Inputs**

- Gamma (`gamma`, text, required): The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
- Viewer ID (`viewer_id`, text, required): The viewer's 'viewerId' from 'List viewers' (people signed in to Gamma only).

**Outputs**

- `cardCount` (number): Cards in the gamma
- `cardsViewed` (number): How many cards they saw
- `displayName` (text): Their name
- `email` (text): Their email
- `gammaId` (text): The gamma's file id
- `lastOpened` (text): When they last opened it (ISO 8601)
- `perCardTimeSpent` (list): Every card, in order
- `scope` (text): all (every viewer's activity) or self (only your own)
- `userId` (text): The viewer's id

**Example output**

```json
{
  "cardCount": 5,
  "cardsViewed": 5,
  "displayName": "Sam Lee",
  "email": "sam@example.com",
  "gammaId": "g_l0mf2jvf1fpmi1v",
  "lastOpened": "2026-10-22T16:05:00.000Z",
  "perCardTimeSpent": [
    {
      "cardId": "card_1",
      "cardName": "Q3 product launch plan",
      "cardPosition": 1,
      "viewTimePercent": 34
    }
  ],
  "scope": "all",
  "userId": "user_2"
}
```

### List comments

List the comment threads on a gamma, with their replies, the text they point at and who wrote them. You need comment access.

**Inputs**

- Gamma (`gamma`, text, required): The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
- Active since (`updated_since`, date and time): Only threads with new comments or replies after this time.
- Include deleted (`include_archived`, true/false): Also list deleted comments and replies. Default: `false`.
- Page size (`limit`, number): How many to return, 1 to 50. From 1 to 50.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `comments` (list): The comment threads
- `count` (number): How many on this page
- `has_more` (true/false): Whether there are more
- `next_cursor` (text): Pass as 'Next page cursor' to get the next page

**Example output**

```json
{
  "comments": [
    {
      "archived": false,
      "author": {
        "id": "user_1",
        "name": "Jo Bloggs"
      },
      "cardId": "card_2",
      "contentText": "Can we move this a week later?",
      "createdTime": "2026-10-21T10:00:00.000Z",
      "id": "cmt_1",
      "mentionedUsers": [],
      "replies": [],
      "status": "open",
      "targetHtml": "<p>Launch on 1 November</p>",
      "targetText": "Launch on 1 November",
      "updatedTime": "2026-10-21T10:00:00.000Z"
    }
  ],
  "count": 1,
  "has_more": false,
  "next_cursor": ""
}
```

### List folders

List the workspace folders you're a member of.

**Inputs**

- Name contains (`query`, text): Only folders whose name matches.
- Page size (`limit`, number): How many to return, 1 to 50. From 1 to 50.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `folders` (list): The folders
- `has_more` (true/false): Whether there are more
- `next_cursor` (text): Pass as 'Next page cursor' to get the next page

**Example output**

```json
{
  "count": 1,
  "folders": [
    {
      "id": "fld_9x2",
      "name": "Sales decks"
    }
  ],
  "has_more": false,
  "next_cursor": ""
}
```

### List themes

List the themes you can use: Gamma's built-in ones and your workspace's own, with their color and tone keywords.

**Inputs**

- Name contains (`query`, text): Only themes whose name matches.
- Kind (`theme_type`, text): Only built-in themes, or only your workspace's own. One of: `standard` (Gamma's built-in themes), `custom` (Your workspace's own themes).
- Page size (`limit`, number): How many to return, 1 to 50. From 1 to 50.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): Whether there are more
- `next_cursor` (text): Pass as 'Next page cursor' to get the next page
- `themes` (list): The themes

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "themes": [
    {
      "colorKeywords": [
        "white",
        "blue"
      ],
      "id": "default-light",
      "name": "Default Light",
      "toneKeywords": [
        "clean",
        "professional"
      ],
      "type": "standard"
    }
  ]
}
```

### List viewers

List who viewed a gamma, when they last opened it and how many cards they saw (at most 500). Needs a Gamma Pro plan or higher; without manage access you see only yourself.

**Inputs**

- Gamma (`gamma`, text, required): The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
- Order (`sort_direction`, text): By when they last opened it. One of: `desc` (Most recently opened first), `asc` (Least recently opened first).
- Page size (`limit`, number): How many to return, 1 to 50. From 1 to 50.
- Next page cursor (`after`, text): The 'next_cursor' from an earlier page, to get the page after it.

**Outputs**

- `count` (number): How many on this page
- `gamma_id` (text): The gamma's file id
- `has_more` (true/false): Whether there are more
- `next_cursor` (text): Pass as 'Next page cursor' to get the next page
- `scope` (text): all (every viewer) or self (only you)
- `viewers` (list): The viewers

**Example output**

```json
{
  "count": 1,
  "gamma_id": "g_l0mf2jvf1fpmi1v",
  "has_more": false,
  "next_cursor": "",
  "scope": "all",
  "viewers": [
    {
      "cardsViewed": 5,
      "displayName": "Sam Lee",
      "email": "sam@example.com",
      "lastOpened": "2026-10-22T16:05:00.000Z",
      "viewerId": "user_2"
    }
  ]
}
```

### Search gammas

Find gammas by words in their title or text, who made them or when they changed, up to 25. With nothing filled in, lists the most recently changed.

**Inputs**

- Search for (`query`, text): Words in the title or text.
- Made by (`created_by`, text): me, or a teammate's email address.
- Changed after (`updated_after`, date and time): Only gammas changed on or after this time.
- Changed before (`updated_before`, date and time): Only gammas changed on or before this time.
- Include archived (`include_archived`, true/false): Also find archived gammas. Default: `false`.
- How many (`limit`, number): At most this many, 1 to 25. From 1 to 25.

**Outputs**

- `count` (number): How many
- `gammas` (list): The gammas found

**Example output**

```json
{
  "count": 1,
  "gammas": [
    {
      "archived": false,
      "createdBy": "Jo Bloggs",
      "highlight": "the Q3 launch timeline",
      "id": "g_l0mf2jvf1fpmi1v",
      "title": "Q3 product launch plan",
      "updatedTime": "2026-10-21T09:30:00.000Z",
      "url": "https://gamma.app/docs/Q3-product-launch-plan-abc123"
    }
  ]
}
```

### Search templates

Find templates to start from: your workspace's own and Gamma's official ones, up to 25 of each. Use an id with 'Create gamma from template'.

**Inputs**

- Search for (`query`, text): Words to look for. Leave empty to see recent ones.
- How many (`limit`, number): At most this many of each kind, 1 to 25. From 1 to 25.

**Outputs**

- `count` (number): How many in all
- `explore_templates` (list): Gamma's official templates
- `workspace_templates` (list): Your workspace's templates

**Example output**

```json
{
  "count": 2,
  "explore_templates": [
    {
      "id": "tmpl_pitch01",
      "previewUrl": "https://cdn.gamma.app/example/preview.png",
      "thumbnailUrl": "https://cdn.gamma.app/example/thumb.png",
      "title": "Pitch deck",
      "url": "https://gamma.app/templates/pitch-deck"
    }
  ],
  "workspace_templates": [
    {
      "id": "g_launchdeck1a2b3c",
      "previewUrl": "https://cdn.gamma.app/example/preview.png",
      "title": "Product launch deck",
      "url": "https://gamma.app/docs/Product-launch-deck-launchdeck1"
    }
  ]
}
```
