Flows - Get run status

curl --request GET \
  --url https://api.magnific.com/v1/ai/flows/runs/{run-id} \
  --header 'x-magnific-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-magnific-api-key': '<api-key>'}};

fetch('https://api.magnific.com/v1/ai/flows/runs/{run-id}', 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/runs/{run-id}",
  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/runs/{run-id}"

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

}

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/flows/runs/{run-id}")

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": {
    "run_id": "omps2OH829",
    "status": "completed",
    "app_id": "uqzQLDr2Aw",
    "started_at": "2026-02-25T12:00:00.000Z",
    "completed_at": "2026-02-25T12:02:00.000Z",
    "error_message": null,
    "result": {
      "images": [
        {
          "id": "abc123",
          "url": "https://pikaso.cdnpk.net/private/production/1234567890/render.png?token=exp_1234567890~hmac_abc123",
          "tool": "text-to-image",
          "duration": null,
          "width": 1024,
          "height": 1024,
          "created_at": "2026-02-25T12:02:00.000Z"
        }
      ],
      "videos": [],
      "audios": []
    }
  }
}

Flows API

Flows - Get run status

Retrieve the current status and results of a flow execution run.

Use this endpoint to poll the status of a run after calling the POST /v1/ai/flows/{flow-id}/run endpoint. The run_id path parameter corresponds to the workflow_run_identifier returned in the run response.

Polling strategy:

Wait 2-3 seconds after starting the run before the first poll
Poll every 3-5 seconds
When status is completed, the result field contains download URLs
When status is failed, the error_message field describes the failure

Asset URLs in the result field are temporary and valid for 12 hours.

Statuses:

Status	Description
`pending`	Run is queued but has not started yet
`running`	Flow is executing
`completed`	Finished successfully, `result` is available
`completed_with_errors`	Execution finished but some nodes failed
`failed`	Execution failed, see `error_message`
`cancelled`	Execution was cancelled

GET

flows

runs

{run-id}

Flows - Get run status

curl --request GET \
  --url https://api.magnific.com/v1/ai/flows/runs/{run-id} \
  --header 'x-magnific-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-magnific-api-key': '<api-key>'}};

fetch('https://api.magnific.com/v1/ai/flows/runs/{run-id}', 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/runs/{run-id}",
  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/runs/{run-id}"

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

}

require 'uri'
require 'net/http'

url = URI("https://api.magnific.com/v1/ai/flows/runs/{run-id}")

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": {
    "run_id": "omps2OH829",
    "status": "completed",
    "app_id": "uqzQLDr2Aw",
    "started_at": "2026-02-25T12:00:00.000Z",
    "completed_at": "2026-02-25T12:02:00.000Z",
    "error_message": null,
    "result": {
      "images": [
        {
          "id": "abc123",
          "url": "https://pikaso.cdnpk.net/private/production/1234567890/render.png?token=exp_1234567890~hmac_abc123",
          "tool": "text-to-image",
          "duration": null,
          "width": 1024,
          "height": 1024,
          "created_at": "2026-02-25T12:02:00.000Z"
        }
      ],
      "videos": [],
      "audios": []
    }
  }
}

Authorizations

x-magnific-api-key

string

header

required

Your Magnific API key. Required for authentication. Learn how to obtain an API key

Path Parameters

run-id

string

required

Unique identifier (SQID) of the flow run. This is the workflow_run_identifier value returned by the POST /v1/ai/flows/{flow-id}/run endpoint.

Example:

"omps2OH829"

Response

OK - Run status and result.

data

object

required

Status and result of a single flow execution run.

Show child attributes

Example:

{
  "error_message": "error_message",
  "result": {
    "images": [
      {
        "duration": 0.8008281904610115,
        "width": 6,
        "created_at": "2026-02-11T10:14:15.000Z",
        "id": "LSFgqqrswO",
        "url": "https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...",
        "tool": "text-to-image",
        "height": 1
      },
      {
        "duration": 0.8008281904610115,
        "width": 6,
        "created_at": "2026-02-11T10:14:15.000Z",
        "id": "LSFgqqrswO",
        "url": "https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...",
        "tool": "text-to-image",
        "height": 1
      }
    ],
    "audios": [
      {
        "duration": 0.8008281904610115,
        "width": 6,
        "created_at": "2026-02-11T10:14:15.000Z",
        "id": "LSFgqqrswO",
        "url": "https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...",
        "tool": "text-to-image",
        "height": 1
      },
      {
        "duration": 0.8008281904610115,
        "width": 6,
        "created_at": "2026-02-11T10:14:15.000Z",
        "id": "LSFgqqrswO",
        "url": "https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...",
        "tool": "text-to-image",
        "height": 1
      }
    ],
    "videos": [
      {
        "duration": 0.8008281904610115,
        "width": 6,
        "created_at": "2026-02-11T10:14:15.000Z",
        "id": "LSFgqqrswO",
        "url": "https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...",
        "tool": "text-to-image",
        "height": 1
      },
      {
        "duration": 0.8008281904610115,
        "width": 6,
        "created_at": "2026-02-11T10:14:15.000Z",
        "id": "LSFgqqrswO",
        "url": "https://pikaso.cdnpk.net/private/production/3280037299/render.png?token=...",
        "tool": "text-to-image",
        "height": 1
      }
    ]
  },
  "completed_at": "2026-02-25T12:02:00.000Z",
  "run_id": "omps2OH829",
  "started_at": "2026-02-25T12:00:00.000Z",
  "app_id": "uqzQLDr2Aw",
  "status": "completed"
}

Flows - Run a flow

ElevenLabs Music API

⌘I

Get started

APIs

Flows - Get run status

Authorizations

Path Parameters

Response