---
title: "Flows - List flows"
method: GET
path: "/v1/ai/flows"
tags: ["flows"]
---

# Flows - List flows

`GET /v1/ai/flows`

## Request

- Base URL: `https://api.magnific.com`
- URL: `https://api.magnific.com/v1/ai/flows`
- Auth: API key in header `x-magnific-api-key`

Returns all flows **published as tools** that the authenticated user can execute.
Each item includes the flow identifier, name, and tool metadata.

Flows are visual AI pipelines built in [Magnific Spaces](https://www.magnific.com/spaces).
Each flow chains together multiple AI tools (upscale, generate, edit, etc.) and can be executed via API.

**Use this endpoint to discover** runnable flows, then call the detail endpoint to get input definitions before running them.

## Query parameters

- `search` string

## Response `200`

OK - List of flows.

- InlineObject6
  - `data` FlowSummary[], required
    - `sqid` string: Short unique identifier of the flow.
    - `name` string: Human-readable name of the flow.
    - `tool_metadata` ToolMetadata: Metadata about the tool (UI hints, cost, categorization).
      - `icon` string: Icon identifier for UI rendering.
      - `description_key` string, nullable: Translation key for the tool description.
      - `translation_key` string, nullable: Translation key for the tool name.
      - `category` string: Category for grouping tools.
      - `sort_order` integer: Display order within category.
      - `total_cost` integer: Total credit cost per execution (sum of all workflow nodes).

## Other responses

- `401`: Unauthorized - The client must authenticate itself to get the requested response.
- `500`: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- `503`: Service Unavailable

---

[API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)