Gamma
App · 23 actions
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.
Actions
| Action | What it does |
|---|---|
| Archive gamma | Archive a gamma so it leaves the workspace's lists without being deleted. |
| Archive image | Remove an image from your Gamma media library. |
| Create gamma | Have the Gamma agent make a presentation, document or social post from a brief, in one of your themes. |
| Create gamma from template | Have the Gamma agent make a new gamma starting from a template or an existing gamma, keeping its look. |
| 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. |
| Create image | Make an on-brand image from a description, saved to your Gamma media library. |
| Delete gamma | Delete a gamma for good. |
| Edit gamma | Change a gamma by describing the change, such as "update the pricing card with the new tiers". |
| Export gamma | Export any gamma you can view to PDF, PowerPoint or PNG images. |
| Get card analytics | See, card by card, how long people spent and what share of viewers reached it. |
| Get edit | Check on an edit by the 'edit_id' an 'Edit gamma' step returned. |
| Get export | Check on an export by the 'export_id' an 'Export gamma' step returned. |
| Get gamma | Get a gamma's title, link, preview image, author, theme and dates, by its id or address. |
| Get gamma analytics | Get a gamma's views, unique viewers and editors, when it was last opened and 30 days of daily viewers. |
| 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. |
| Get image | Check on an image by the 'image_generation_id' a 'Create image' step returned. |
| Get viewer analytics | See how one viewer read a gamma: when they last opened it and the share of their time on each card. |
| List comments | List the comment threads on a gamma, with their replies, the text they point at and who wrote them. |
| List folders | List the workspace folders you're a member of. |
| List themes | List the themes you can use: Gamma's built-in ones and your workspace's own, with their color and tone keywords. |
| List viewers | List who viewed a gamma, when they last opened it and how many cards they saw (at most 500). |
| Search gammas | Find gammas by words in their title or text, who made them or when they changed, up to 25. |
| Search templates | Find templates to start from: your workspace's own and Gamma's official ones, up to 25 of each. |
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
gammatextRequired - The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
Outputs
archivedtrue/false- True once archived
gamma_idtext- The gamma's file id
titletext- The gamma's title
Example output
{
"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_idtextRequired - The 'saved_media_id' 'Create image' or 'Get image' returned.
Outputs
archivedtrue/false- True once archived
saved_media_idtext- The image archived
Example output
{
"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
prompttextRequired - 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
formattext - What to make. Defaults to a presentation.One of:
presentation(Presentation (default)),document,social(Social post). Default:presentation. - Number of cards
num_cardsnumber - 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_idtext - The look: colors, fonts and logo. Pick one of your workspace's themes.
- Quality
qualitytext - 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_instructionstext - Tone, audience, language or style to aim for, up to 5,000 characters.
- Source links
source_urlslist - Up to 10 web pages for the agent to read and draw on. A page it can't read is skipped.
- Folder
folder_idtext - The Gamma folder to put it in. Leave empty for none.
- Also export as
export_astext - 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_accesstext - 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_accesstext - 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_emailslist - Email addresses to share it with. Gamma emails each one an invitation.
- Their access
email_accesstext - 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
waittrue/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_deductednumber- Credits this job used, once it has finished
credits_remainingnumber- Credits left in the workspace
errortext- Why it failed, if it did
export_urltext- 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_idtext- The new gamma's id, for later steps
gamma_urltext- The link to open the gamma in Gamma
generation_idtext- The generation's id, for 'Get generation'
progress_percentnumber- How far along it is, 0 to 100
statustext- pending, completed or failed
summarytext- The Gamma agent's summary of what it made
warningslist- Settings Gamma ignored or adjusted
Example output
{
"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_idtextRequired - 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
prompttextRequired - 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
formattext - What to make. Defaults to a presentation.One of:
presentation(Presentation (default)),document,social(Social post). Default:presentation. - Number of cards
num_cardsnumber - 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
qualitytext - 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_instructionstext - Tone, audience, language or style to aim for, up to 5,000 characters.
- Source links
source_urlslist - Up to 10 web pages for the agent to read and draw on. A page it can't read is skipped.
- Folder
folder_idtext - The Gamma folder to put it in. Leave empty for none.
- Also export as
export_astext - 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_accesstext - 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_accesstext - 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_emailslist - Email addresses to share it with. Gamma emails each one an invitation.
- Their access
email_accesstext - 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
waittrue/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_deductednumber- Credits this job used, once it has finished
credits_remainingnumber- Credits left in the workspace
errortext- Why it failed, if it did
export_urltext- 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_idtext- The new gamma's id, for later steps
gamma_urltext- The link to open the gamma in Gamma
generation_idtext- The generation's id, for 'Get generation'
progress_percentnumber- How far along it is, 0 to 100
statustext- pending, completed or failed
summarytext- The Gamma agent's summary of what it made
warningslist- Settings Gamma ignored or adjusted
Example output
{
"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_texttextRequired - 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_modetext - 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
formattext - What to make. Defaults to a presentation.One of:
presentation(Presentation (default)),document,social(Social post),webpage. Default:presentation. - Title
titletext - The gamma's title. Leave empty to have one written from the content.
- Number of cards
num_cardsnumber - 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_splittext - 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_idtext - The look: colors, fonts and logo. Leave empty for the workspace default.
- Extra instructions
additional_instructionstext - Tone, audience, language or style to aim for, up to 5,000 characters.
- Text per card
text_amounttext - How much text each card has.One of:
brief,medium(Medium (default)),detailed,extensive. Default:medium. - Tone
tonetext - The writing style, such as professional, upbeat or academic.
- Audience
audiencetext - Who it's for, such as executives or new hires.
- Language
languagetext - 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_sourcetext - 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_modeltext - 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_styletext - The look of the AI images, such as "flat line drawings in navy".Only when Images is AI-generated (default).
- Card size
dimensionstext - 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_idtext - The Gamma folder to put it in. Leave empty for none.
- Also export as
export_astext - 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_accesstext - 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_accesstext - 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_emailslist - Email addresses to share it with. Gamma emails each one an invitation.
- Their access
email_accesstext - 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
waittrue/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_deductednumber- Credits this job used, once it has finished
credits_remainingnumber- Credits left in the workspace
errortext- Why it failed, if it did
export_urltext- 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_idtext- The new gamma's id, for later steps
gamma_urltext- The link to open the gamma in Gamma
generation_idtext- The generation's id, for 'Get generation'
progress_percentnumber- How far along it is, 0 to 100
statustext- pending, completed or failed
summarytext- The Gamma agent's summary of what it made
warningslist- Settings Gamma ignored or adjusted
Example output
{
"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
prompttextRequired - What the image shows, including any background, such as "a rocket on white". Up to 5,000 characters.
- Style
image_typetext - 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_presettext - The image's shape.One of:
social-square(Social square (default)),social-portrait(Social portrait),story,slide,banner. Default:social-square. - Theme
theme_idtext - The brand theme to style it with. Leave empty for the workspace default.
- Reference images
reference_image_urlslist - Up to 4 https links to pictures of a person or product to put in the image.
- Wait for it to finish
waittrue/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_deductednumber- Credits this job used, once it has finished
credits_remainingnumber- Credits left in the workspace
errortext- Why it failed, if it did
file_formattext- png, webp and so on
heightnumber- Height in pixels
image_generation_idtext- The image job's id, for 'Get image'
image_urltext- The link to the image
mime_typetext- The image's MIME type
saved_media_idtext- The image's id in your Gamma media library
statustext- pending, completed or failed
warningslist- Settings Gamma ignored or adjusted
widthnumber- Width in pixels
Example output
{
"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
gammatextRequired - The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
Outputs
deletedtrue/false- True once deleted
gamma_idtext- The gamma's file id
messagetext- Gamma's confirmation
titletext- The gamma's title
Example output
{
"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
gammatextRequired - The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
- Change to make
prompttextRequired - What to change, in your own words, up to 10,000 characters.
- Quality
qualitytext - 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
waittrue/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_deductednumber- Credits this job used, once it has finished
credits_remainingnumber- Credits left in the workspace
edit_idtext- The edit's id, for 'Get edit'
errortext- Why it failed, if it did
gamma_idtext- The edited gamma's id
gamma_urltext- The link to the edited gamma
page_idtext- The page of the gamma that was edited
statustext- pending, completed or failed
summarytext- The Gamma agent's summary of what it changed
Example output
{
"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
gammatextRequired - The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
- Export as
export_astextRequired - The kind of file.One of:
pdf,pptx(PowerPoint (PPTX)),png(PNG images (a .zip, one per card)). - Wait for it to finish
waittrue/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
errortext- Why it failed, if it did
export_astext- pdf, pptx or png
export_idtext- The export's id, for 'Get export'
export_urltext- The download link, once completed. Anyone with it can download the file for about a week.
gamma_idtext- The exported gamma's id
statustext- pending, completed or failed
Example output
{
"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
gammatextRequired - The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
Outputs
cardCountnumber- Cards in the gamma
cardslist- Every card, in order
gammaIdtext- The gamma's file id
scopetext- all (every viewer's activity) or self (only your own)
uniqueEditorsnumber- Different people who edited it
uniqueViewersnumber- Different people who viewed it
Example output
{
"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_idtextRequired - The 'edit_id' 'Edit gamma' returned.
Outputs
credits_deductednumber- Credits this job used, once it has finished
credits_remainingnumber- Credits left in the workspace
edit_idtext- The edit's id, for 'Get edit'
errortext- Why it failed, if it did
gamma_idtext- The edited gamma's id
gamma_urltext- The link to the edited gamma
page_idtext- The page of the gamma that was edited
statustext- pending, completed or failed
summarytext- The Gamma agent's summary of what it changed
Example output
{
"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_idtextRequired - The 'export_id' 'Export gamma' returned.
Outputs
errortext- Why it failed, if it did
export_astext- pdf, pptx or png
export_idtext- The export's id, for 'Get export'
export_urltext- The download link, once completed. Anyone with it can download the file for about a week.
gamma_idtext- The exported gamma's id
statustext- pending, completed or failed
Example output
{
"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
gammatextRequired - The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
Outputs
gammaobject- The gamma
Example output
{
"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
gammatextRequired - The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
Outputs
cardCountnumber- Cards in the gamma
dailyViewsobject- Viewers per day over the last 30 days
gammaIdtext- The gamma's file id
lastOpenedtext- When it was last viewed (ISO 8601)
scopetext- all (every viewer's activity) or self (only your own)
totalViewsnumber- Times it was opened, counting repeat visits
uniqueEditorsnumber- Different people who edited it
uniqueViewersnumber- Different people who viewed it
Example output
{
"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_idtextRequired - The 'generation_id' a create step returned.
Outputs
credits_deductednumber- Credits this job used, once it has finished
credits_remainingnumber- Credits left in the workspace
errortext- Why it failed, if it did
export_urltext- 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_idtext- The new gamma's id, for later steps
gamma_urltext- The link to open the gamma in Gamma
generation_idtext- The generation's id, for 'Get generation'
progress_percentnumber- How far along it is, 0 to 100
statustext- pending, completed or failed
summarytext- The Gamma agent's summary of what it made
warningslist- Settings Gamma ignored or adjusted
Example output
{
"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_idtextRequired - The 'image_generation_id' 'Create image' returned.
Outputs
credits_deductednumber- Credits this job used, once it has finished
credits_remainingnumber- Credits left in the workspace
errortext- Why it failed, if it did
file_formattext- png, webp and so on
heightnumber- Height in pixels
image_generation_idtext- The image job's id, for 'Get image'
image_urltext- The link to the image
mime_typetext- The image's MIME type
saved_media_idtext- The image's id in your Gamma media library
statustext- pending, completed or failed
warningslist- Settings Gamma ignored or adjusted
widthnumber- Width in pixels
Example output
{
"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
gammatextRequired - The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
- Viewer ID
viewer_idtextRequired - The viewer's 'viewerId' from 'List viewers' (people signed in to Gamma only).
Outputs
cardCountnumber- Cards in the gamma
cardsViewednumber- How many cards they saw
displayNametext- Their name
emailtext- Their email
gammaIdtext- The gamma's file id
lastOpenedtext- When they last opened it (ISO 8601)
perCardTimeSpentlist- Every card, in order
scopetext- all (every viewer's activity) or self (only your own)
userIdtext- The viewer's id
Example output
{
"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
gammatextRequired - The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
- Active since
updated_sincedate and time - Only threads with new comments or replies after this time.
- Include deleted
include_archivedtrue/false - Also list deleted comments and replies.Default:
false. - Page size
limitnumber - How many to return, 1 to 50.From 1 to 50.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
commentslist- The comment threads
countnumber- How many on this page
has_moretrue/false- Whether there are more
next_cursortext- Pass as 'Next page cursor' to get the next page
Example output
{
"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
querytext - Only folders whose name matches.
- Page size
limitnumber - How many to return, 1 to 50.From 1 to 50.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many on this page
folderslist- The folders
has_moretrue/false- Whether there are more
next_cursortext- Pass as 'Next page cursor' to get the next page
Example output
{
"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
querytext - Only themes whose name matches.
- Kind
theme_typetext - 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
limitnumber - How many to return, 1 to 50.From 1 to 50.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many on this page
has_moretrue/false- Whether there are more
next_cursortext- Pass as 'Next page cursor' to get the next page
themeslist- The themes
Example output
{
"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
gammatextRequired - The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
- Order
sort_directiontext - By when they last opened it.One of:
desc(Most recently opened first),asc(Least recently opened first). - Page size
limitnumber - How many to return, 1 to 50.From 1 to 50.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many on this page
gamma_idtext- The gamma's file id
has_moretrue/false- Whether there are more
next_cursortext- Pass as 'Next page cursor' to get the next page
scopetext- all (every viewer) or self (only you)
viewerslist- The viewers
Example output
{
"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
querytext - Words in the title or text.
- Made by
created_bytext - me, or a teammate's email address.
- Changed after
updated_afterdate and time - Only gammas changed on or after this time.
- Changed before
updated_beforedate and time - Only gammas changed on or before this time.
- Include archived
include_archivedtrue/false - Also find archived gammas.Default:
false. - How many
limitnumber - At most this many, 1 to 25.From 1 to 25.
Outputs
countnumber- How many
gammaslist- The gammas found
Example output
{
"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
querytext - Words to look for. Leave empty to see recent ones.
- How many
limitnumber - At most this many of each kind, 1 to 25.From 1 to 25.
Outputs
countnumber- How many in all
explore_templateslist- Gamma's official templates
workspace_templateslist- Your workspace's templates
Example output
{
"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"
}
]
}