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

# List workflows

> List the workflows in a workspace, newest first, a page at a time.

<Note>
  This endpoint is for the VIP plan only. Other plans get a `403`. See [Plan access](/api-reference/introduction#plan-access).
</Note>

List the workflows in a workspace, newest first. The list leaves out the steps. Get one workflow to see them.

## Query Parameters

<ParamField query="workspaceId" type="string">
  The workspace. Required for an account key. A workspace key uses its own workspace.
</ParamField>

<ParamField query="limit" type="integer" optional default="50">
  How many to return, 1 to 100.
</ParamField>

<ParamField query="offset" type="integer" optional default="0">
  How many to skip, up to 100,000.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.nedzo.ai/v1/workflows?limit=20" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "items": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "workspaceId": "223e4567-e89b-12d3-a456-426614174000",
        "name": "Follow up after a call",
        "isPublished": true,
        "isActive": true,
        "version": 3,
        "publishedAt": "2026-10-11T09:00:00Z",
        "createdAt": "2026-10-01T09:00:00Z",
        "updatedAt": "2026-10-11T09:00:00Z"
      }
    ],
    "total": 1,
    "limit": 20,
    "offset": 0,
    "hasMore": false
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.