v8

latestOpenAPI 3.1.1LicenseRef-Proprietaryraw.githubusercontent.com2026-05-19280916.6 KB
Runs

Get a run

Returns status and completed output URLs for a public API run, including action runs started through POST /runs/action.

get/runs/{runId}

Path parameters

runIdstring required

Run identifier

Example:run_abc123

Run identifier

Response

Run returned.

run_idstring required

Run identifier

status'pending' | 'running' | 'completed' | 'failed' required
progressnumber required
created_atnumber required
started_atnumber
completed_atnumber
error_codestring

Machine-readable run error code

error_messagestring

Human-readable run error message

charged_costnumber

Cost charged in USD

poll_urlstring uri

Example response

{
  "run_id": "run_abc123",
  "error_code": "provider_error",
  "error_message": "The provider failed to complete the generation.",
  "outputs": [
    {
      "output_id": "output_1",
      "url": "https://media.flora.ai/output.png"
    }
  ]
}