Skip to main content
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.
Decky writes the whole deck from your brief. Where a slide from its library of designed templates fits, Decky builds that slide from the template. To fill a specific library deck or chosen templates instead, use fill_templates.

Parameters

string
required
What the deck should be about: topic, audience, tone, structure hints, key messages. The more specific, the better the result.
integer
required
Number of slides to generate. Range: 1–40.
string
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_masters lists in builtin_masters.
Omit it to use default_master from list_masters. For work accounts, that is the organization’s default. Otherwise it is Decky’s default, Professional Blue.
string
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.
boolean
default:"true"
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 the id to poll get_deck_status.
string
Unique job identifier.
string
generate for create_deck jobs, fill_templates for fill_templates jobs.
string
One of queued, running, succeeded, failed, canceled.
string | null
The master the job uses. null means Decky’s default master.
string | null
The master’s name, such as "Graphite (Decky built-in)" or "Professional Blue (Decky default)". null if the uploaded master has since been deleted.
integer
Credits held for this job (10 × slides).
integer | null
Final credits charged once the job settles. null while in progress.
boolean
true when the job runs with enterprise data handling.
string
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.