Type: Write · Required scope:
decks:write · Cost: 10 credits per slide, built from scratch or from a library template. Reserved upfront; credits for slides that aren’t produced are refunded automatically.fill_templates.
Parameters
What the deck should be about: topic, audience, tone, structure hints, key messages. The more specific, the better the result.
The master template (design) from
list_masters. It can be:- one of your uploaded masters,
- for work accounts, one of your organization’s company masters,
- one of Decky’s built-in masters: Professional Blue, Graphite, Evergreen, Burgundy, or Petrol,
- a brand master that
list_masterslists inbuiltin_masters.
default_master from list_masters. For work accounts, that is the organization’s default. Otherwise it is Decky’s default, Professional Blue.Source material for the deck that the assistant extracted from the user’s files (Excel, PDF, Word, notes): figures, tables as text, quotes, names, all verbatim. Up to 100,000 characters. Decky quotes figures from it exactly and builds charts from its data. Decky never sees the files: the assistant reads them and passes what the deck needs.
Let Decky build slides from its library of designed templates where one fits. Set it to
false to build every slide from scratch.Response
Returns a job object. Use theid to poll get_deck_status.
generate for create_deck jobs, fill_templates for fill_templates jobs.The master’s name, such as
"Graphite (Decky built-in)" or "Professional Blue (Decky default)". null if the uploaded master has since been deleted.true when the job runs with enterprise data handling.Present when there is something to tell the user about the master the deck uses. For example, that other built-in masters are available, or that the user has uploaded masters but none was chosen.
In clients that show interactive cards (MCP Apps), such as claude.ai and Claude Desktop, the job appears as a live deck card with progress, a cancel button, and previews of the finished slides. See Interactive cards.
Credits
Credits are reserved at 10 per slide when the job is created. When it finishes, Decky charges 10 credits for each slide it produced, whether built from scratch or from a library template (progress.library_slides counts those), and refunds the rest. For example, a 10-slide job reserves 100 credits. If it makes 9 slides, it is charged 90 and 10 are refunded. Failed or canceled jobs are refunded in full.
AI-generated images, icons, and web searches that Decky uses while writing the deck are charged separately from the slide reservation: 20 credits per AI-generated image, 1 per icon, and 1 per web search. See Credits & Plans.
Job statuses
Examples
Errors
Credits are reserved at submission time. If the job fails or is canceled, all reserved credits are refunded. Maximum 40 slides per job. For longer decks, create multiple jobs.