---
title: "list all flows"
method: GET
path: "/w/{workspace}/flows/list"
tags: ["flow"]
---

# list all flows

`GET /w/{workspace}/flows/list`

## Path parameters

- `workspace` string, required

## Query parameters

- `page` integer
- `per_page` integer
- `order_desc` boolean
- `created_by` string
- `path_start` string
- `path_exact` string
- `show_archived` boolean
- `starred_only` boolean
- `include_draft_only` boolean
- `with_deployment_msg` boolean
- `without_description` boolean
- `dedicated_worker` boolean
- `label` string

## Changes

> 176 revisions in range; 16 could not be searched.

- **2026-08-01** `7943381eeb29` — 1 info
  - added the optional property `items/allOf[#/components/schemas/Flow]/allOf[#/components/schemas/FlowMetadata]/on_behalf_of` to the response with the `200` status

[Change history](https://skmtc.dev/windmill/apis/windmill-api/changes/w/:workspace/flows/list/get.md)

---

[API](https://skmtc.dev/windmill/apis/windmill-api.md) · [All operations](https://skmtc.dev/windmill/apis/windmill-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/windmill/windmill-api/revisions/7b281701c340/schema)