---
title: listWorkflows
description: Gateway RPC for listing registered workflows.
maturity: stable
apiVersion: v1
---

- Method: `listWorkflows`
- Scope: `run:read`
- Transports: HTTP RPC, WebSocket RPC
- Request: `{ filter?: { hasUi?: boolean; includeSystem?: boolean } }`
- Response: `GatewayWorkflowSummary[]`

Errors are versioned as `v1` and include `InvalidRequest`, `Unauthorized`, `Forbidden`, and `Internal`.

Each summary includes `key`, `hasUi`, `uiPath`, and `system`. `readableName` and `description` are included when the workflow exposes them. System (internal plumbing) workflows are excluded by default; pass `filter.includeSystem: true` to include them, and the `system` boolean marks them.
