---
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`

The task status.

- object
  - `id` string, uuid, required — The ID of the task being returned.
  - `status` 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'PENDING' | 'CANCELLED' | 'THROTTLED', required — - `PENDING` tasks have been enqueued and are waiting to run. - `THROTTLED` tasks are waiting to be enqueued until other jobs have finished running. - `RUNNING` tasks are currently being processed. - `SUCCEEDED` tasks have completed successfully. - `FAILED` tasks have failed. - `CANCELLED` tasks have been aborted.
  - `createdAt` string, date-time, required — The timestamp that the task was submitted at.
  - `failure` string — If the status is `FAILED`, this will contain a human-friendly reason for the failure.
  - `failureCode` string — If the task has a status of `FAILED`, this contains a machine-readable error code. This is a dot-separated string, with the leftmost segment being the most generic and the rightmost segment being the most specific. For example, `SAFETY.INPUT.TEXT` would indicate that the task failed due to a content moderation error on the input text.
  - `output` string[] — If the status is `SUCCEEDED`, this will contain an array of strings. Each string will be a URL that returns an output from the task. URLs 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.
  - `progress` number — If the task has a status of `RUNNING`, this will contain a floating point number between 0 and 1 representing the progress of the generation.

## Other responses

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

---

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