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

# List Workflow

> List workflows for a workspace

List workflows in a workspace with pagination. Returns workflow slug, name, status, and version info. Use `--mode` to switch between draft and live versions.

## Syntax

```bash theme={"system"}
suprsend workflow list [flags]
```

## Flags

| Flag                  | Description                                | Default  |
| --------------------- | ------------------------------------------ | -------- |
| `-h, --help`          | Show help for the command                  | –        |
| `-l, --limit int`     | Maximum number of workflows to return      | `20`     |
| `-f, --offset int`    | Number of workflows to skip for pagination | `0`      |
| `-m, --mode string`   | Version mode: draft or live                | `live`   |
| `-o, --output string` | Output format: pretty, json, or yaml       | `pretty` |

<Tip>
  Use `-o json` for machine-readable JSON output, `-o yaml` for YAML. Default `-o pretty` outputs a human-friendly table.
</Tip>

## Example

```bash theme={"system"}
# List live workflows in staging workspace
suprsend workflow list

# List with custom limit and workspace
suprsend workflow list --limit 50 --workspace production

# List draft workflows
suprsend workflow list --mode draft

# piping JSON output to jq
suprsend workflow list --output json | jq '.[].slug'

```