create_deck

Type: Write · Required scope: decks:write · Cost: 10 credits per slide, reserved upfront. Unused credits are refunded automatically if the job produces fewer slides.

Parameters

string

required

What the deck should be about — topic, audience, tone, structure, key facts. The more specific, the better the result.

integer

required

Number of slides to generate. Range: 1–40.

string

ID of an uploaded brand template (from list_masters). Omit to use the default Decky design.

Response

Returns a job object. Use the id to poll get_deck_status.

string

Unique job identifier.

string

One of queued, running, succeeded, failed, canceled.

integer

Credits held for this job (10 × slides).

integer | null

Final credits charged once the job settles. null while in progress.

Show Example response

{
  "id": "job_abc123",
  "status": "queued",
  "prompt": "10-slide investor pitch for a B2B SaaS startup...",
  "master_id": null,
  "slides_requested": 10,
  "credits_reserved": 100,
  "credits_charged": null,
  "progress": null,
  "error": null,
  "created_at": "2026-06-23T10:00:00Z",
  "finished_at": null
}

Job statuses

Status	Meaning
`queued`	Waiting to start
`running`	Generation in progress
`succeeded`	Deck is ready for download
`failed`	Generation failed (see `error`)
`canceled`	Canceled via `cancel_deck`

Example prompts

Create a 12-slide strategic pitch deck for Maven Labs, a B2B SaaS company
that automates financial reporting for mid-market CFOs. Audience: Series B
investors. Include: problem, solution, market size ($8B TAM), product demo
slide, traction (3x YoY growth), team, and ask ($5M). Tone: confident,
data-driven. Use charts and bullet points.

10-slide deck on the future of renewable energy

Create a 15-slide product launch deck for our new enterprise security
product. Use master_id "tmpl_xyz789". Audience: IT decision makers.

Errors

Error	Cause	Fix
`Insufficient credits`	Not enough credits for the slide count	Reduce slides or upgrade
`Too many active jobs`	You already have jobs queued or running	Wait or `cancel_deck`
`Unknown master_id`	The template ID doesn’t exist on your account	Call `list_masters`

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.

Get Started

Authentication

Guides

Tool Reference

Help

Parameters

Response

Job statuses

Example prompts

Errors

​Parameters

​Response

​Job statuses

​Example prompts

​Errors

Parameters

Response

Job statuses

Example prompts

Errors