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

ActionWhat it does
Archive gammaArchive a gamma so it leaves the workspace's lists without being deleted.
Archive imageRemove an image from your Gamma media library.
Create gammaHave the Gamma agent make a presentation, document or social post from a brief, in one of your themes.
Create gamma from templateHave the Gamma agent make a new gamma starting from a template or an existing gamma, keeping its look.
Create gamma from textTurn your text into a presentation, document, social post or webpage, choosing exactly how the text is used, the language, images and card size.
Create imageMake an on-brand image from a description, saved to your Gamma media library.
Delete gammaDelete a gamma for good.
Edit gammaChange a gamma by describing the change, such as "update the pricing card with the new tiers".
Export gammaExport any gamma you can view to PDF, PowerPoint or PNG images.
Get card analyticsSee, card by card, how long people spent and what share of viewers reached it.
Get editCheck on an edit by the 'edit_id' an 'Edit gamma' step returned.
Get exportCheck on an export by the 'export_id' an 'Export gamma' step returned.
Get gammaGet a gamma's title, link, preview image, author, theme and dates, by its id or address.
Get gamma analyticsGet a gamma's views, unique viewers and editors, when it was last opened and 30 days of daily viewers.
Get generationCheck on a gamma being made, by the generation id a 'Create gamma' step returned; once done, get its link and download link.
Get imageCheck on an image by the 'image_generation_id' a 'Create image' step returned.
Get viewer analyticsSee how one viewer read a gamma: when they last opened it and the share of their time on each card.
List commentsList the comment threads on a gamma, with their replies, the text they point at and who wrote them.
List foldersList the workspace folders you're a member of.
List themesList the themes you can use: Gamma's built-in ones and your workspace's own, with their color and tone keywords.
List viewersList who viewed a gamma, when they last opened it and how many cards they saw (at most 500).
Search gammasFind gammas by words in their title or text, who made them or when they changed, up to 25.
Search templatesFind 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

GammagammatextRequired
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 IDsaved_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 makeprompttextRequired
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.
Formatformattext
What to make. Defaults to a presentation.One of: presentation (Presentation (default)), document, social (Social post). Default: presentation.
Number of cardsnum_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.
Themetheme_idtext
The look: colors, fonts and logo. Pick one of your workspace's themes.
Qualityqualitytext
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 instructionsadditional_instructionstext
Tone, audience, language or style to aim for, up to 5,000 characters.
Source linkssource_urlslist
Up to 10 web pages for the agent to read and draw on. A page it can't read is skipped.
Folderfolder_idtext
The Gamma folder to put it in. Leave empty for none.
Also export asexport_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 accessworkspace_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 linkexternal_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 withshare_with_emailslist
Email addresses to share it with. Gamma emails each one an invitation.
Their accessemail_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 finishwaittrue/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

Templatetemplate_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 makeprompttextRequired
The content to put in it, and how closely to follow the template, such as "Keep every card and layout; only replace the content."
Formatformattext
What to make. Defaults to a presentation.One of: presentation (Presentation (default)), document, social (Social post). Default: presentation.
Number of cardsnum_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.
Qualityqualitytext
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 instructionsadditional_instructionstext
Tone, audience, language or style to aim for, up to 5,000 characters.
Source linkssource_urlslist
Up to 10 web pages for the agent to read and draw on. A page it can't read is skipped.
Folderfolder_idtext
The Gamma folder to put it in. Leave empty for none.
Also export asexport_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 accessworkspace_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 linkexternal_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 withshare_with_emailslist
Email addresses to share it with. Gamma emails each one an invitation.
Their accessemail_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 finishwaittrue/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

Textinput_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 totext_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).
Formatformattext
What to make. Defaults to a presentation.One of: presentation (Presentation (default)), document, social (Social post), webpage. Default: presentation.
Titletitletext
The gamma's title. Leave empty to have one written from the content.
Number of cardsnum_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 cardscard_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.
Themetheme_idtext
The look: colors, fonts and logo. Leave empty for the workspace default.
Extra instructionsadditional_instructionstext
Tone, audience, language or style to aim for, up to 5,000 characters.
Text per cardtext_amounttext
How much text each card has.One of: brief, medium (Medium (default)), detailed, extensive. Default: medium.
Tonetonetext
The writing style, such as professional, upbeat or academic.
Audienceaudiencetext
Who it's for, such as executives or new hires.
Languagelanguagetext
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.
Imagesimage_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 modelimage_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 styleimage_styletext
The look of the AI images, such as "flat line drawings in navy".Only when Images is AI-generated (default).
Card sizedimensionstext
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)).
Folderfolder_idtext
The Gamma folder to put it in. Leave empty for none.
Also export asexport_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 accessworkspace_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 linkexternal_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 withshare_with_emailslist
Email addresses to share it with. Gamma emails each one an invitation.
Their accessemail_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 finishwaittrue/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

DescriptionprompttextRequired
What the image shows, including any background, such as "a rocket on white". Up to 5,000 characters.
Styleimage_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.
Shapesize_presettext
The image's shape.One of: social-square (Social square (default)), social-portrait (Social portrait), story, slide, banner. Default: social-square.
Themetheme_idtext
The brand theme to style it with. Leave empty for the workspace default.
Reference imagesreference_image_urlslist
Up to 4 https links to pictures of a person or product to put in the image.
Wait for it to finishwaittrue/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

GammagammatextRequired
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

GammagammatextRequired
The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
Change to makeprompttextRequired
What to change, in your own words, up to 10,000 characters.
Qualityqualitytext
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 finishwaittrue/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

GammagammatextRequired
The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
Export asexport_astextRequired
The kind of file.One of: pdf, pptx (PowerPoint (PPTX)), png (PNG images (a .zip, one per card)).
Wait for it to finishwaittrue/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

GammagammatextRequired
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 IDedit_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 IDexport_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

GammagammatextRequired
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

GammagammatextRequired
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 IDgeneration_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 IDimage_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

GammagammatextRequired
The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
Viewer IDviewer_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

GammagammatextRequired
The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
Active sinceupdated_sincedate and time
Only threads with new comments or replies after this time.
Include deletedinclude_archivedtrue/false
Also list deleted comments and replies.Default: false.
Page sizelimitnumber
How many to return, 1 to 50.From 1 to 50.
Next page cursoraftertext
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 containsquerytext
Only folders whose name matches.
Page sizelimitnumber
How many to return, 1 to 50.From 1 to 50.
Next page cursoraftertext
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 containsquerytext
Only themes whose name matches.
Kindtheme_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 sizelimitnumber
How many to return, 1 to 50.From 1 to 50.
Next page cursoraftertext
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

GammagammatextRequired
The gamma. Pick a recent one, or give its id or its gamma.app/docs/... address.
Ordersort_directiontext
By when they last opened it.One of: desc (Most recently opened first), asc (Least recently opened first).
Page sizelimitnumber
How many to return, 1 to 50.From 1 to 50.
Next page cursoraftertext
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 forquerytext
Words in the title or text.
Made bycreated_bytext
me, or a teammate's email address.
Changed afterupdated_afterdate and time
Only gammas changed on or after this time.
Changed beforeupdated_beforedate and time
Only gammas changed on or before this time.
Include archivedinclude_archivedtrue/false
Also find archived gammas.Default: false.
How manylimitnumber
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 forquerytext
Words to look for. Leave empty to see recent ones.
How manylimitnumber
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"
    }
  ]
}

On this page