> ## 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.

# Workflows auflisten

> Liste Workflows, die der API-Key in deinem Workspace sehen kann

Gibt Workflows ohne Vorlagen zurück, die der API-Key-User sehen kann. Workspace-Admin-Identitäten, inklusive Workspace-API-Keys, erhalten jeden Workflow ohne Vorlage im Workspace.

## Basis-URL

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

<Warning>
  **Dedicated Deployments**

  Ersetze `api.langdock.com` durch `<your-deployment-url>/api/public` in allen Anfragen.
</Warning>

## Erforderliche Scopes

Dieser Endpoint erfordert den `WORKFLOW_API` Scope (**Workflow-Lese-API**).

## Parameter

| Parameter | Typ     | Erforderlich | Beschreibung                                                           |
| --------- | ------- | ------------ | ---------------------------------------------------------------------- |
| `limit`   | integer | Nein         | Anzahl der zurückzugebenden Workflows. Standard: `50`. Maximum: `250`. |
| `cursor`  | string  | Nein         | Workflow-UUID aus `nextCursor` der vorherigen Antwort.                 |

## Beispiel

```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();
```

## Antwortformat

### Erfolgreiche Antwort (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;
}
```

Listeneinträge enthalten den Graphen nicht. Nutze [Workflow abrufen](/de/developer/workflow-api/get-workflow) für Entwurf und veröffentlichte Nodes.

## Fehlerbehandlung

| Statuscode | Beschreibung                      |
| ---------- | --------------------------------- |
| 400        | Ungültiger Query-Parameter        |
| 401        | Ungültiger oder fehlender API-Key |
| 403        | Fehlender `WORKFLOW_API` Scope    |
| 429        | Rate Limit überschritten          |
| 500        | Interner Serverfehler             |

<Info>
  Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu [Best Practices für API-Schlüssel](/de/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"

````