---
title: "Get task detail"
method: GET
path: "/v1/tasks/{id}"
tags: ["Task management"]
---

# Get task detail

`GET /v1/tasks/{id}`

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

## Path parameters

- `id` string, uuid, required

## Headers

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

## Response `200`

Success

- union
  - object — A pending task
    - `id` string, uuid, required — The ID of the task being returned.
    - `createdAt` string, date-time, required — The timestamp that the task was submitted at.
    - `status` 'PENDING', required
  - object — A throttled task
    - `id` string, uuid, required — The ID of the task being returned.
    - `createdAt` string, date-time, required — The timestamp that the task was submitted at.
    - `status` 'THROTTLED', required
  - object — A cancelled or deleted task
    - `id` string, uuid, required — The ID of the task being returned.
    - `createdAt` string, date-time, required — The timestamp that the task was submitted at.
    - `status` 'CANCELLED', required
  - object — A running task
    - `id` string, uuid, required — The ID of the task being returned.
    - `createdAt` string, date-time, required — The timestamp that the task was submitted at.
    - `status` 'RUNNING', required
    - `progress` number, required
  - object — A failed task
    - `id` string, uuid, required — The ID of the task being returned.
    - `createdAt` string, date-time, required — The timestamp that the task 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.
  - object — A succeeded task
    - `id` string, uuid, required — The ID of the task being returned.
    - `createdAt` string, date-time, required — The timestamp that the task was submitted at.
    - `status` 'SUCCEEDED', required
    - `output` string[], required — An array of URLs that return the output of the task. These URLs will expire within 24-48 hours; fetch the task again to get fresh URLs. It is expected that you download the assets at these URLs and store them in your own storage system.

## Other responses

- `404` — The task does not exist, or was deleted or canceled.

---

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