# Flowg8 · Flows auflisten

Liste Workspace-Flows. Übergebe nextCursor als optionalen cursor-Query, bis der Wert null ist.



## GET /v1/flows

Authentication: restricted integration key (scope: flows:read) or Flowg8 sign-in access token
Required tenant header: X-Organization-Id.
Required user permissions: Aktive Workspace-Mitgliedschaft erforderlich. The API checks current membership, roles, key scopes and resource permissions on every request. Documentation visibility grants no access.

## Request example (replace example IDs)

```sh
curl "https://api.flowg8.io/v1/flows" \
  -H "authorization: Bearer $FLOWG8_API_KEY" \
  -H "x-organization-id: 10000000-0000-4000-8000-000000000001"
```

## Response excerpt

```json
{
  "items": [
    {
      "id": "10000000-0000-4000-8000-000000000002",
      "name": "Deployment approval",
      "publishedVersion": 1
    }
  ],
  "nextCursor": null
}
```

Source: /docs/list-flows
Full schemas: /docs/openapi.json