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

# List workflows

> Returns the user's workflows, most-recently-updated first.

### Query parameters

<ParamField query="limit" type="integer" default="20">
  Max number of workflows. 1-100.
</ParamField>

### Response

<ResponseField name="workflows" type="array">
  Workflow summary objects. Includes `id`, `name`, `description`, `duration`,
  `thumbnail_url`, `updated_at`, `created_at`.
</ResponseField>

<ResponseField name="count" type="integer">
  Number of items returned.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.lavendly.ai/v1/workflows?limit=10 \
    -H 'Authorization: Bearer $LAVENDLY_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "count": 2,
    "workflows": [
      { "id": "wf_xyz", "name": "Bookshop fox", "duration": 5,
        "updated_at": 1734001234567 },
      { "id": "wf_old", "name": "Old draft", "duration": 0,
        "updated_at": 1733991122000 }
    ]
  }
  ```
</ResponseExample>