get_deck_status

Type: Read · Required scope: decks:read · Cost: Free

Parameters

string

required

The job ID returned by create_deck.

Response

string

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

object | null

While running, progress.slides_done shows how many slides are finished.

integer | null

Final credits charged once settled; refunded to 0 on failure or cancel.

Show Example response

{
  "id": "job_abc123",
  "status": "running",
  "prompt": "10-slide investor pitch...",
  "master_id": null,
  "slides_requested": 10,
  "credits_reserved": 100,
  "credits_charged": null,
  "progress": { "slides_done": 4 },
  "error": null,
  "created_at": "2026-06-23T10:00:00Z",
  "finished_at": null
}

Status lifecycle

Status	`progress.slides_done`	`finished_at`	`credits_charged`
`queued`	`null`	`null`	`null`
`running`	Updates as slides finish	`null`	`null`
`succeeded`	Equal to slides produced	Set	Final value
`failed`	Last value before failure	Set	Refunded to 0
`canceled`	Last value	Set	Refunded to 0

Polling recommendations

Claude polls automatically. You only need to call this tool manually if you’re building a custom integration.

Poll every 10 seconds while status is queued or running.
A 10-slide deck typically takes 3–7 minutes; a 40-slide deck up to 20 minutes.
Stop polling as soon as status is succeeded, failed, or canceled.

Errors

Error	Cause
`Deck job 'X' not found`	Invalid job ID, or it belongs to another account. Call `list_decks`.

Get Started

Authentication

Guides

Tool Reference

Help

Parameters

Response

Status lifecycle

Polling recommendations

Errors

​Parameters

​Response

​Status lifecycle

​Polling recommendations

​Errors

Parameters

Response

Status lifecycle

Polling recommendations

Errors