---
title: "Retrieve task run"
method: GET
path: "/task-runs/{taskRunId}"
tags: ["Workflow Tasks (Beta)"]
---

# Retrieve task run

`GET /task-runs/{taskRunId}`

Retrieve the workflow task run with the provided ID.

## Response `200`

Task run details

- object
  - `id` string, required
  - `taskId` string, required
  - `status` Status, required — unresolved $ref
  - `results` unknown[], required
    - unknown
  - `error` string — Error message if the task run failed.
  - `startedAt` string, date-time
  - `completedAt` string, date-time
  - `input` Input, required — unresolved $ref
  - `parentTaskRunId` string, required
  - `rootTaskRunId` string, required
  - `retries` integer, required
  - `attempts` object[], required
    - `status` Status, required — unresolved $ref
    - `enqueuedAt` string, date-time
    - `startedAt` string, date-time, required
    - `completedAt` string, date-time
    - `error` string — Error message if the task attempt failed.
    - `results` Results — unresolved $ref

## Other responses

- `401` — Authorization information is missing or invalid.
- `403` — You do not have permissions for the requested resource.
- `404` — Unable to find the requested resource.
- `429` — Rate limit has been surpassed.
- `500` — An unexpected server error has occurred.
- `503` — Server currently unavailable.

---

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