Generate a Gamma presentation, document, webpage, or social post from text.

Generation is asynchronous. Returns a generationId; poll gamma_get_status until status is 'completed' or 'failed' to retrieve the share URL.

Args: input_text: Topic, outline, or full content (1-400000 chars). text_mode: How to interpret input — 'generate' (expand), 'condense', or 'preserve' (keep as-is). Default 'generate'. format: Output type — 'presentation', 'document', 'social', or 'webpage'. Omit to use Gamma's default. theme_id: Theme ID from gamma_list_themes. Omit for default theme. num_cards: Target card count (minimum 1, plan-dependent maximum). 0 = let Gamma decide. card_split: 'auto' or 'inputTextBreaks' (splits on blank lines in input). additional_instructions: Extra style/content guidance (max 5000 chars). export_as: Auto-export format — 'pdf', 'pptx', or 'png'. Empty for no export. folder_ids: Workspace folder IDs to place the output in (max 10). Use gamma_list_folders to discover IDs. text_options: Nested object with 'amount' (brief|medium|detailed|extensive), 'tone' (string, max 500 chars), 'audience' (string, max 500 chars), 'language' (ISO code, e.g. 'en', 'es', 'fr'). image_options: Nested object with 'source' (aiGenerated, pictographic, unsplash, webAllImages, webFreeToUse, webFreeToUseCommercially, giphy, pexels, placeholder, noImages, themeAccent), 'model' (e.g. 'dall-e-3', 'imagen-4-ultra', 'flux-2-pro'), 'style' (string, max 500 chars). card_options: Nested object with 'dimensions' (fluid, 16x9, 4x3, pageless, letter, a4, 1x1, 4x5, 9x16 — must match format) and 'headerFooter' (6-position layout with logos, card numbers, or text). sharing_options: Nested object with 'workspaceAccess' (noAccess, view, comment, edit, fullAccess), 'externalAccess' (noAccess, view, comment, edit), and 'emailOptions' ({recipients: [...], access: ...}).

Call gamma_describe_options to inspect accepted enum values.

Generate a variant from an existing Gamma template with swapped content.

Uses POST /generations/from-template. The template Gamma must have exactly one Page. Layout is preserved; new content is generated from the prompt. Ideal for batch content with consistent branding — per-segment investor decks, per-lead LinkedIn cards, rebranded decks per channel partner.

Args: prompt: Content description for the new variant (1-400000 chars). gamma_id: The Gamma ID of the template file (required). theme_id: Optional theme ID to override the template's theme. image_options: Same shape as gamma_generate's image_options. sharing_options: Same shape as gamma_generate's sharing_options. folder_ids: Workspace folder IDs to place the output in (max 10). export_as: Auto-export format — 'pdf', 'pptx', or 'png'.

Poll a generation job to retrieve status and results.

Call after gamma_generate or gamma_generate_from_template with the returned generationId. Poll every few seconds until status is 'completed' or 'failed'. On completion, the response includes gammaUrl (shareable link), exportUrl (if exportAs was requested), and credits (deducted/remaining).

Args: generation_id: The generationId returned from a generate call.

List themes available in the authenticated workspace.

Returns both standard and custom themes with their IDs plus colorKeywords and toneKeywords metadata (50+ themes at last count). Cursor-paginated. Use the returned theme ID as the theme_id parameter when calling gamma_generate or gamma_generate_from_template.

Args: query: Filter themes by name substring (e.g. 'dark'). Empty for no filter. limit: Results per page (1-50). 0 = let Gamma decide (default). after: Cursor from a previous response's nextCursor for pagination.

List workspace folders the authenticated user is a member of.

Cursor-paginated. Use the returned folder IDs as the folder_ids parameter when calling gamma_generate or gamma_generate_from_template to place output into specific folders.

Args: query: Filter folders by name substring. Empty for no filter. limit: Results per page (1-50). 0 = let Gamma decide. after: Cursor from a previous response's nextCursor for pagination.

Describe accepted enum values for Gamma API parameters.

Local lookup — no network call. Helps you discover valid values without trial and error.

Args: category: Specific category to describe. One of: textModes, formats, cardSplits, textAmounts, imageSources, cardDimensions, cardDimensionsByFormat, exportTypes, workspaceAccessLevels, externalAccessLevels, emailAccessLevels, headerFooterElementTypes, headerFooterImageSources, headerFooterImageSizes, headerFooterPositions. Empty to list all categories. format: When category is cardDimensions or cardDimensionsByFormat, filter to allowed dimensions for a specific format (presentation, document, social, webpage).