Get Run Status

Poll a blueprint run to check progress, view completed steps, and retrieve output URLs.

GET/api/v1/runs/{runId}

Path Parameters

runId -- The ID returned when you started the run.

Response

The response includes the run status, step-level progress counts, a top-level finalOutputs array with outputs from leaf nodes (steps with no further connected nodes), and the full steps array with all per-step outputs.

Response shape

{
  "runId": "run_abc123",
  "blueprintId": "bp_xyz",
  "status": "running",
  "startedAt": "2026-03-20T12:00:00Z",
  "completedAt": null,
  "progress": {
    "totalSteps": 5,
    "completedSteps": 3,
    "failedSteps": 0,
    "runningSteps": 1
  },
  "finalOutputs": [
    {
      "type": "editor",
      "outputId": "ejo_1",
      "url": "https://storage.example.com/video.mp4",
      "mimeType": "video/mp4",
      "width": 1920,
      "height": 1080,
      "durationMs": 15000
    }
  ],
  "steps": [
    {
      "stepId": "step_001",
      "referenceId": "step_abc",
      "name": "Generate background",
      "status": "succeeded",
      "predecessorsLeft": 0,
      "attemptNo": 1,
      "startedAt": "2026-03-20T12:00:01Z",
      "completedAt": "2026-03-20T12:00:10Z",
      "outputs": [
        {
          "type": "inference",
          "outputId": "ijo_1",
          "url": "https://storage.example.com/output.png",
          "mimeType": "image/png",
          "width": 1920,
          "height": 1080
        }
      ]
    },
    {
      "stepId": "step_002",
      "referenceId": "step_def",
      "name": "Render video",
      "status": "succeeded",
      "predecessorsLeft": 0,
      "attemptNo": 1,
      "startedAt": "2026-03-20T12:00:10Z",
      "completedAt": "2026-03-20T12:00:25Z",
      "outputs": [
        {
          "type": "editor",
          "outputId": "ejo_1",
          "url": "https://storage.example.com/video.mp4",
          "mimeType": "video/mp4",
          "width": 1920,
          "height": 1080,
          "durationMs": 15000
        }
      ]
    },
    {
      "stepId": "step_003",
      "referenceId": "step_xyz",
      "name": "Publish",
      "status": "running",
      "predecessorsLeft": 0,
      "attemptNo": 1,
      "startedAt": "2026-03-20T12:00:25Z",
      "completedAt": null,
      "outputs": []
    }
  ]
}

Final Outputs

The finalOutputs array contains outputs from leaf nodes only -- steps that have no further connected nodes downstream. These are the end results of your pipeline. Intermediate outputs (e.g. a generated image that feeds into an editor step) are excluded from this array but still available in the per-step outputs within steps.

Status Values

Status	Description
`queued`	Run is waiting to start
`running`	Steps are being executed
`succeeded`	All steps completed successfully
`failed`	One or more steps failed
`skipped`	Step was skipped (counts as completed)
`locked`	Step is locked (counts as completed)

Output Types

Each output in a step's outputs array has a type field indicating where it came from.

Type	Description
`inference`	AI generation output (image, video, audio, text)
`editor`	Video/audio editing output
`output`	Publish output with status and platform details

Example

GET/api/v1/runs/{runId}

curl -X GET https://api.wondercat.ai/api/v1/runs/run_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"