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

# List Workflows

> List workflows the API key can see in your workspace

Returns non-template workflows visible to the API key user. Workspace admin identities, including workspace API keys, receive every non-template workflow in the workspace.

## Base URL

```
https://api.langdock.com/workflows/v1/list
```

<Warning>
  **Dedicated deployments**

  Replace `api.langdock.com` with `<your-deployment-url>/api/public` in all requests.
</Warning>

## Required scopes

This endpoint requires the `WORKFLOW_API` scope (**Workflow Read API**).

## Parameters

| Parameter | Type    | Required | Description                                                   |
| --------- | ------- | -------- | ------------------------------------------------------------- |
| `limit`   | integer | No       | Number of workflows to return. Default: `50`. Maximum: `250`. |
| `cursor`  | string  | No       | Workflow UUID from `nextCursor` in the previous response.     |

## Example

```javascript theme={null}
const axios = require("axios");

async function listWorkflows() {
  const response = await axios.get(
    "https://api.langdock.com/workflows/v1/list",
    {
      params: { limit: 50 },
      headers: {
        Authorization: "Bearer YOUR_API_KEY"
      }
    }
  );

  console.log("Workflows:", response.data.workflows);
  return response.data.nextCursor;
}

listWorkflows();
```

## Response format

### Success response (200 OK)

```typescript theme={null}
{
  workflows: Array<{
    id: string;
    name: string;
    description: string | null;
    status: "ACTIVE" | "INACTIVE";
    timezone: string | null;
    createdAt: string;
    updatedAt: string;
    createdBy: string;
    owner: { id: string; name: string | null };
    accessRole: "user" | "editor" | "owner";
    hasPublishedVersion: boolean;
    activeVersion: { id: string; version: string } | null;
  }>;
  nextCursor?: string;
}
```

List items do not include the graph. Use [Get a workflow](/en/developer/workflow-api/get-workflow) for draft and published nodes.

## Error handling

| Status code | Description                  |
| ----------- | ---------------------------- |
| 400         | Invalid query parameter      |
| 401         | Invalid or missing API key   |
| 403         | Missing `WORKFLOW_API` scope |
| 429         | Rate limit exceeded          |
| 500         | Internal server error        |

<Info>
  Langdock intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. For more information, please see our guide on [API Key Best Practices](/en/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices).
</Info>


## OpenAPI

````yaml GET /workflows/v1/list
openapi: 3.0.0
info:
  title: Langdock API
  version: 3.0.0
servers:
  - url: https://api.langdock.com
    description: Production
security:
  - bearerAuth: []
paths:
  /workflows/v1/list:
    get:
      tags:
        - Workflows
      summary: List workflows
      description: Returns non-template workflows visible to the API key user.
      operationId: listWorkflows
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 250
            default: 50
          description: Number of workflows to return.
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: Workflow UUID from nextCursor in the previous response.
      responses:
        '200':
          description: Workflows returned successfully
        '400':
          description: Invalid query parameter
        '401':
          description: Invalid or missing API key
        '403':
          description: Missing WORKFLOW_API scope
        '429':
          description: Rate limit exceeded
        '500':
          description: Internal server error
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: API key as Bearer token. Format "Bearer YOUR_API_KEY"

````