flows

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:

StatusDescription
pendingRun is queued but has not started yet
runningFlow is executing
completedFinished successfully, result is available
completed_with_errorsExecution finished but some nodes failed
failedExecution failed, see error_message
cancelledExecution was cancelled
get/v1/ai/flows/runs/{run-id}

Request

  • Base URL: https://api.magnific.com
  • URL: https://api.magnific.com/v1/ai/flows/runs/{run-id}
  • Auth: API key in header x-magnific-api-key

Path parameters

run-idstring required
Example:omps2OH829

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.

Response

OK - Run status and result.

Example response

{
  "data": {
    "error_message": "error_message",
    "result": {
      "images": [
        {
          "duration": 0.8008281904610115,
          "width": 6,
          "created_at": "2026-02-11T10:14:15Z",
          "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:15Z",
          "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:15Z",
          "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:15Z",
          "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:15Z",
          "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:15Z",
          "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:00Z",
    "run_id": "omps2OH829",
    "started_at": "2026-02-25T12:00:00Z",
    "app_id": "uqzQLDr2Aw",
    "status": "completed"
  }
}

Changes

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