Flows - List flows
curl --request GET \
--url https://api.magnific.com/v1/ai/flows \
--header 'x-magnific-api-key: <api-key>'import requests
url = "https://api.magnific.com/v1/ai/flows"
headers = {"x-magnific-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-magnific-api-key': '<api-key>'}};
fetch('https://api.magnific.com/v1/ai/flows', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.magnific.com/v1/ai/flows",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-magnific-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.magnific.com/v1/ai/flows"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-magnific-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.magnific.com/v1/ai/flows")
.header("x-magnific-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.magnific.com/v1/ai/flows")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-magnific-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"sqid": "uqzQLDr2Aw",
"name": "Sketch to Realism",
"tool_metadata": {
"icon": "workflow",
"description_key": null,
"translation_key": null,
"category": "general",
"sort_order": 999,
"total_cost": 5
}
},
{
"sqid": "n0LYQDBl58",
"name": "Product Photoshoot",
"tool_metadata": {
"icon": "workflow",
"description_key": null,
"translation_key": null,
"category": "general",
"sort_order": 999,
"total_cost": 8
}
},
{
"sqid": "hCivqLJltZ",
"name": "Anime Style Transfer",
"tool_metadata": {
"icon": "workflow",
"description_key": null,
"translation_key": null,
"category": "general",
"sort_order": 999,
"total_cost": 5
}
}
]
}Flows API
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
Flows - List flows
curl --request GET \
--url https://api.magnific.com/v1/ai/flows \
--header 'x-magnific-api-key: <api-key>'import requests
url = "https://api.magnific.com/v1/ai/flows"
headers = {"x-magnific-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-magnific-api-key': '<api-key>'}};
fetch('https://api.magnific.com/v1/ai/flows', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.magnific.com/v1/ai/flows",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-magnific-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.magnific.com/v1/ai/flows"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-magnific-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.magnific.com/v1/ai/flows")
.header("x-magnific-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.magnific.com/v1/ai/flows")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-magnific-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"sqid": "uqzQLDr2Aw",
"name": "Sketch to Realism",
"tool_metadata": {
"icon": "workflow",
"description_key": null,
"translation_key": null,
"category": "general",
"sort_order": 999,
"total_cost": 5
}
},
{
"sqid": "n0LYQDBl58",
"name": "Product Photoshoot",
"tool_metadata": {
"icon": "workflow",
"description_key": null,
"translation_key": null,
"category": "general",
"sort_order": 999,
"total_cost": 8
}
},
{
"sqid": "hCivqLJltZ",
"name": "Anime Style Transfer",
"tool_metadata": {
"icon": "workflow",
"description_key": null,
"translation_key": null,
"category": "general",
"sort_order": 999,
"total_cost": 5
}
}
]
}Authorizations
Your Magnific API key. Required for authentication. Learn how to obtain an API key
Query Parameters
Filter flows by name (case-insensitive substring match).
Maximum string length:
200Response
OK - List of flows.
Show child attributes
Show child attributes
Was this page helpful?
⌘I