# Search workflows

Lists available flows as lightweight summaries, with optional filtering and pagination.

Request:
includeDisabled - When true, includes flows with DISABLED status in the results.
Defaults to false (only DRAFT and ENABLED flows are returned).
pagination       - Optional Pagination cursor and page size for iterating large result sets.

Response:
items            - List of FlowSummary objects (id, name, description, status, timestamps)
ordered by name. Does not include full task tree details.
pageCursor      - Opaque cursor to pass in a subsequent request to retrieve the next page.
Absent when there are no further results.

Endpoint: POST /api/v1/flow/list
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `includeDisabled` (boolean)

  - `pagination` (any)

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string)
    Rule data fields

  - `items.name` (string)
    Rule data fields

  - `items.description` (string)
    Rule data fields

  - `items.status` (integer)
    Enum: 0, 1, 2

  - `items.createdDt` (object)

  - `items.createdDt.seconds` (integer)

  - `items.createdDt.nanos` (integer)

  - `items.updatedDt` (object)

  - `pageCursor` (string)
    Rule data fields

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)