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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Start List download

> Start an asynchronous CSV or JSON export of a Slack List.

`slack.startListDownload` starts an export job. Use `slack.getListDownload` with the returned job ID.

```ts automations/export-release-list.automation.ts theme={null}
import { automation, onDashboardRun } from "automate.ax"
import { slack } from "automate.ax/slack"

export default automation("Export release List", () => {
  onDashboardRun({ title: "Export release List" })

  slack.startListDownload({
    listId: "F012ABCD3EF",
    format: "json",
    includeThreads: true,
    includeAttachments: true,
  })
})
```

## Inputs

| Input                | Type              | Required | Default       | Description                                                    |
| -------------------- | ----------------- | -------- | ------------- | -------------------------------------------------------------- |
| `listId`             | `string`          | Yes      | None          | List to export.                                                |
| `format`             | `"csv" \| "json"` | No       | `csv`         | JSON preserves hierarchy and supports threads and attachments. |
| `includeArchived`    | `boolean`         | No       | Slack default | Includes archived items.                                       |
| `includeThreads`     | `boolean`         | No       | Slack default | Includes item threads; JSON only.                              |
| `includeAttachments` | `boolean`         | No       | Slack default | Includes attachment metadata and paths; JSON only.             |

## Output

Returns `{ jobId: string }`.