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

# workflows list

> List workflows in the workspace pinned to your API key.

List the workflows available to the authenticated workspace. Each entry returns the workflow `id`, `name`, and a `url` that opens it in Clay. Use [`clay workflows get`](/cli/reference/workflows-get) to fetch a single workflow.

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay workflows list [--limit <n>] [--cursor <token>]
```

Results are paginated. `--limit` sets the page size, and the response includes a top-level `cursor` when more workflows are available; pass it back with `--cursor` to fetch the next page.

## Flags

| Flag               | Description                                                                      |
| ------------------ | -------------------------------------------------------------------------------- |
| `--limit <n>`      | Maximum workflows to return per page. A positive integer, 1–200. Defaults to 50. |
| `--cursor <token>` | Resume from a previous response's `cursor` to fetch the next page.               |

## Output

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": [
    {
      "id": "wf_abc123",
      "name": "Lead enrichment",
      "url": "https://app.clay.com/..."
    }
  ],
  "cursor": "next_page_token"
}
```

| Field         | Type   | Description                                                                                       |
| ------------- | ------ | ------------------------------------------------------------------------------------------------- |
| `data[].id`   | string | Workflow id, e.g. `wf_abc123`.                                                                    |
| `data[].name` | string | Display name.                                                                                     |
| `data[].url`  | string | Link that opens the workflow in Clay.                                                             |
| `cursor`      | string | Present when more workflows are available. Pass it back via `--cursor`. Omitted on the last page. |

## Errors

| Code               | Exit | Notes                                               |
| ------------------ | ---- | --------------------------------------------------- |
| `validation_error` | 2    | `--limit` is not a positive integer or exceeds 200. |
| `auth_forbidden`   | 3    | The API key lacks the `terracotta:cli` scope.       |

## Examples

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
clay workflows list
clay workflows list --limit 10 | jq -r '.data[].id'
clay workflows list | jq -r '.data[] | "\(.id)\t\(.name)"'
clay workflows list --cursor "$CURSOR"
```