> ## Documentation Index
> Fetch the complete documentation index at: https://docs.decky-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# list_decks

> List your recent deck generation jobs, newest first.

<Info>
  **Type:** Read · **Required scope:** `decks:read` · **Cost:** Free
</Info>

## Parameters

<ParamField path="limit" type="integer" default="20">
  Number of jobs to return. Range: **1–100**. Jobs are returned newest first.
</ParamField>

## Response

Returns an array of job objects (same shape as [`get_deck_status`](/tools/get-deck-status)).

<Expandable title="Example response">
  ```json theme={null}
  [
    {
      "id": "job_abc123",
      "status": "succeeded",
      "prompt": "10-slide investor pitch for...",
      "slides_requested": 10,
      "credits_charged": 100,
      "created_at": "2026-06-23T10:00:00Z",
      "finished_at": "2026-06-23T10:08:43Z"
    },
    {
      "id": "job_def456",
      "status": "running",
      "prompt": "5-slide product overview...",
      "slides_requested": 5,
      "credits_reserved": 50,
      "credits_charged": null,
      "created_at": "2026-06-23T10:15:00Z",
      "finished_at": null
    }
  ]
  ```
</Expandable>

## Use cases

* Find a job ID you've lost track of.
* Check whether a long-running job has finished.
* Review your generation history.