Flows - List flows

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. 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.

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

Query parameters

searchstring

Filter flows by name (case-insensitive substring match).

Response

OK - List of flows.

Example response

{
  "data": [
    {
      "name": "Sketch to Realism",
      "tool_metadata": {
        "total_cost": 5,
        "icon": "workflow",
        "translation_key": "translation_key",
        "description_key": "description_key",
        "category": "general",
        "sort_order": 999
      },
      "sqid": "uqzQLDr2Aw"
    },
    {
      "name": "Sketch to Realism",
      "tool_metadata": {
        "total_cost": 5,
        "icon": "workflow",
        "translation_key": "translation_key",
        "description_key": "description_key",
        "category": "general",
        "sort_order": 999
      },
      "sqid": "uqzQLDr2Aw"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.