---
title: "Get workflow invocation detail"
method: GET
path: "/v1/workflow_invocations/{id}"
tags: ["Workflows"]
---

# Get workflow invocation detail

`GET /v1/workflow_invocations/{id}`

Return details about a workflow invocation. Consumers of this API should not expect updates more frequent than once every five seconds for a given workflow invocation.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Runway-Version` '2024-11-06', required

## Response `200`

Success

- union
  - object — A pending workflow invocation
    - `id` string, uuid, required — The ID of the workflow invocation being returned.
    - `createdAt` string, date-time, required — The timestamp that the workflow invocation was submitted at.
    - `status` 'PENDING', required
  - object — A throttled workflow invocation
    - `id` string, uuid, required — The ID of the workflow invocation being returned.
    - `createdAt` string, date-time, required — The timestamp that the workflow invocation was submitted at.
    - `status` 'THROTTLED', required
  - object — A cancelled or deleted workflow invocation
    - `id` string, uuid, required — The ID of the workflow invocation being returned.
    - `createdAt` string, date-time, required — The timestamp that the workflow invocation was submitted at.
    - `status` 'CANCELLED', required
  - object — A running workflow invocation
    - `id` string, uuid, required — The ID of the workflow invocation being returned.
    - `createdAt` string, date-time, required — The timestamp that the workflow invocation was submitted at.
    - `status` 'RUNNING', required
    - `progress` number, required — A number between 0 and 1 representing the overall workflow execution progress.
    - `output` object, required — A record mapping workflow node IDs to arrays of output URLs for nodes that have already completed. This allows streaming partial results while the workflow is still running.
    - `nodeErrors` object — A record mapping workflow node IDs to their error details. Only present when one or more nodes have errored.
  - object — A failed workflow invocation
    - `id` string, uuid, required — The ID of the workflow invocation being returned.
    - `createdAt` string, date-time, required — The timestamp that the workflow invocation was submitted at.
    - `status` 'FAILED', required
    - `failure` string, required — A human-friendly reason for the failure. We do not recommend returning this to users directly without adding context.
    - `failureCode` string — A machine-readable error code for the failure. See https://docs.dev.runwayml.com/errors/task-failures/ for more information.
    - `nodeErrors` object — A record mapping workflow node IDs to their error details. Only present when one or more nodes have errored.
  - object — A succeeded workflow invocation
    - `id` string, uuid, required — The ID of the workflow invocation being returned.
    - `createdAt` string, date-time, required — The timestamp that the workflow invocation was submitted at.
    - `status` 'SUCCEEDED', required
    - `output` object, required — A record mapping workflow node IDs to arrays of output URLs. Each key is the UUID of a workflow node that produced output, and each value is an array of URLs for that node's artifacts. These URLs will expire within 24-48 hours; fetch the invocation again to get fresh URLs. It is expected that you download the assets at these URLs and store them in your own storage system.
    - `nodeErrors` object — A record mapping workflow node IDs to their error details. Even when the overall workflow succeeds, individual nodes may have encountered non-fatal errors. Only present when one or more nodes have errored.

## Other responses

- `404` — The workflow invocation does not exist, was deleted or canceled, or is not a workflow task.

---

[API](https://skmtc.net/runwayml/apis/runwayml-api.md) · [All operations](https://skmtc.net/runwayml/apis/runwayml-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/runwayml/runwayml-api/revisions/e7d9a59ac7b0/schema)