Get a run
Poll a run’s status and, once complete, its output media URLs.
GET
/
v1
/
runs
/
{runId}
Get a run
curl --request GET \
--url https://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId}', 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://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"runId": "64c3f2a1e8b9c0d1f2e3a4b5",
"appId": "507f1f77bcf86cd799439011",
"appTitle": "Headshot generator",
"status": "completed",
"outputs": [
{
"nodeId": "node_9",
"kind": "image",
"url": "https://cdn.tryflowy.ai/runs/headshot.png",
"text": "<string>"
}
],
"error": "<string>",
"createdAt": "2026-01-01T00:00:00Z",
"updatedAt": "2026-01-01T00:00:05Z"
}
}{
"error": "this API key lacks the runs:write scope"
}{
"error": "this API key lacks the runs:write scope"
}{
"error": "this API key lacks the runs:write scope"
}Output media URLs are signed and expire. Download or copy the asset to your own storage soon after the run completes.
There’s no separate
outputs array. The result surface is nodeResults, the run’s full per-node record (executed nodes only, in no guaranteed order): each entry carries nodeId, status (completed | failed), and, when it produced content, kind plus url or text. The entries with isOutput: true are the ones the flow publishes by name. Filter on that flag to get what Run a flow calls the run’s outputs. A node missing from nodeResults was never executed. When the run was started with params, they’re echoed back on the record as params (typed, as sent); inputs stays the content values, as strings.Authorizations
A workspace API key. Secret keys (flowy_…) are server-side — keep them private. Publishable keys (flowy_pk_…) are browser-safe but only work from their allowlisted domains.
Path Parameters
Response
Run status and outputs.
Show child attributes
Show child attributes
Last modified on September 8, 2026
Was this page helpful?
⌘I
Get a run
curl --request GET \
--url https://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId}', 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://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://apis.tryflowy.ai/genstudio-svc-v2/api/v1/runs/{runId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"runId": "64c3f2a1e8b9c0d1f2e3a4b5",
"appId": "507f1f77bcf86cd799439011",
"appTitle": "Headshot generator",
"status": "completed",
"outputs": [
{
"nodeId": "node_9",
"kind": "image",
"url": "https://cdn.tryflowy.ai/runs/headshot.png",
"text": "<string>"
}
],
"error": "<string>",
"createdAt": "2026-01-01T00:00:00Z",
"updatedAt": "2026-01-01T00:00:05Z"
}
}{
"error": "this API key lacks the runs:write scope"
}{
"error": "this API key lacks the runs:write scope"
}{
"error": "this API key lacks the runs:write scope"
}