---
title: "Retrieve a Task"
method: GET
path: "/task/{taskId}"
tags: ["task"]
---

# Retrieve a Task

`GET /task/{taskId}`

## Path parameters

- `taskId` string, required

## Response `200`

Success

- Task — unresolved $ref

## Other responses

- `default` — Error

## Changes

- **2024-08-28** `974b6b23f2e9` — 1 info
  - added the optional property `projectId` to the response with the `200` status
- **2024-07-17** `7292d77807a3` — 1 breaking
  - the `output/upload/assetSpec/storage` response's property type/format changed from ``/`` to `object`/`` for status `200`
- **2024-06-18** `82356f03be94` — 4 breaking, 3 warning
  - the response property `output/upload/assetSpec/profiles/items/fps` became optional for the status `200`
  - the response property `output/upload/assetSpec/profiles/items/height` became optional for the status `200`
  - the response property `output/upload/assetSpec/profiles/items/name` became optional for the status `200`
  - the response property `output/upload/assetSpec/profiles/items/width` became optional for the status `200`
  - …3 more
- **2024-06-13** `5e75bbdc48f8` — 1 info
  - added the optional property `output/upload/assetSpec/profiles` to the response with the `200` status
- **2024-06-03** `91531fe2df78` — 1 breaking
  - the response property `output/upload/assetSpec/hash` became nullable for the status `200`

[Full history](https://skmtc.dev/livepeer/apis/livepeer-api-reference/changes/task/:taskId/get.md)

---

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