---
title: "Read Flows"
method: GET
path: "/api/v1/flows/"
tags: ["Flows"]
---

# Read Flows

`GET /api/v1/flows/`

Retrieve a list of flows with optional pagination, filtering, and header-only mode.

## Query parameters

- `remove_example_flows` boolean
- `components_only` boolean
- `get_all` boolean
- `folder_id` string, uuid, nullable
- `flow_type` 'workflow' | 'agent'
- `header_flows` boolean
- `page` integer
- `size` integer

## Response `200`

Successful Response

- union
  - FlowRead[]
    - `a2a_card_overrides` object, nullable — User overrides for the generated A2A agent card (skill description, examples, tags)
    - `a2a_enabled` boolean, nullable — Can be exposed as an A2A agent (only meaningful when flow_type=agent)
    - `access_type` 'PRIVATE' | 'PUBLIC'
    - `action_description` string, nullable — The description of the action associated with the flow
    - `action_name` string, nullable — The name of the action associated with the flow
    - `data` object, nullable
    - `description` string, nullable
    - `endpoint_name` string, nullable
    - `flow_type` 'workflow' | 'agent'
    - `folder_id` string, uuid, nullable, required
    - `gradient` string, nullable
    - `icon` string, nullable
    - `icon_bg_color` string, nullable
    - `id` string, uuid, required
    - `is_component` boolean, nullable
    - `locked` boolean, nullable
    - `mcp_enabled` boolean, nullable — Can be exposed in the MCP server
    - `name` string, required
    - `name_key` string, nullable — Stable i18n key derived from the original English name
    - `tags` string[], nullable — The tags of the flow
    - `updated_at` string, date-time, nullable
    - `user_id` string, uuid, nullable, required
    - `webhook` boolean, nullable — Can be used on the webhook endpoint
    - `workspace_id` string, uuid, nullable
  - PageFlowRead
    - `items` FlowRead[], required
      - `a2a_card_overrides` object, nullable — User overrides for the generated A2A agent card (skill description, examples, tags)
      - `a2a_enabled` boolean, nullable — Can be exposed as an A2A agent (only meaningful when flow_type=agent)
      - `access_type` 'PRIVATE' | 'PUBLIC'
      - `action_description` string, nullable — The description of the action associated with the flow
      - `action_name` string, nullable — The name of the action associated with the flow
      - `data` object, nullable
      - `description` string, nullable
      - `endpoint_name` string, nullable
      - `flow_type` 'workflow' | 'agent'
      - `folder_id` string, uuid, nullable, required
      - `gradient` string, nullable
      - `icon` string, nullable
      - `icon_bg_color` string, nullable
      - `id` string, uuid, required
      - `is_component` boolean, nullable
      - `locked` boolean, nullable
      - `mcp_enabled` boolean, nullable — Can be exposed in the MCP server
      - `name` string, required
      - `name_key` string, nullable — Stable i18n key derived from the original English name
      - `tags` string[], nullable — The tags of the flow
      - `updated_at` string, date-time, nullable
      - `user_id` string, uuid, nullable, required
      - `webhook` boolean, nullable — Can be used on the webhook endpoint
      - `workspace_id` string, uuid, nullable
    - `page` integer, required
    - `pages` integer, required
    - `size` integer, required
    - `total` integer, required
  - FlowHeader[]
    - `a2a_card_overrides` object, nullable — User overrides for the served A2A agent card
    - `a2a_enabled` boolean, nullable — Flag indicating whether the flow is exposed as an A2A agent
    - `access_type` 'PRIVATE' | 'PUBLIC'
    - `action_description` string, nullable — The description of the action associated with the flow
    - `action_name` string, nullable — The name of the action associated with the flow
    - `data` object, nullable — The data of the component, if is_component is True
    - `description` string, nullable — A description of the flow
    - `endpoint_name` string, nullable — The name of the endpoint associated with this flow
    - `flow_type` 'workflow' | 'agent'
    - `folder_id` string, uuid, nullable — The ID of the folder containing the flow. None if not associated with a folder
    - `id` string, uuid, required — Unique identifier for the flow
    - `is_component` boolean, nullable — Flag indicating whether the flow is a component
    - `mcp_enabled` boolean, nullable — Flag indicating whether the flow is exposed in the MCP server
    - `name` string, required — The name of the flow
    - `tags` string[], nullable — The tags of the flow

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/langflow-ai/apis/langflow.md) · [All operations](https://skmtc.net/langflow-ai/apis/langflow/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langflow-ai/langflow/versions/22962dc5e81b/schema)