Get a run

GET

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

}

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

Authorization

string

header

required

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

runId

string

required

Response

Run status and outputs.

data

object

Show child attributes

Last modified on September 8, 2026

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

}

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"
}

Get started

Endpoints

Reference

Authorizations

Path Parameters

Response