---
title: "Get Task"
method: GET
path: "/lowpoly/tasks/{task_id}"
tags: ["lowpoly"]
---

# Get Task

`GET /lowpoly/tasks/{task_id}`

## Request

- Base URL: `https://api.retrodiffusion.ai/v2`
- URL: `https://api.retrodiffusion.ai/v2/lowpoly/tasks/{task_id}`
- Auth: none declared. Required headers: `X-RD-Token`

## Path parameters

- `task_id` string, required

## Headers

- `X-RD-Token` string, required

## Response `200`

Successful Response

- LowPolyTaskRead
  - `status` string, required
  - `task_id` string, required
  - `operation` string
  - `asset_id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `result` LowPolyAssetRead
    - `asset_id` string, required
    - `status` string, required
    - `prompt` string
    - `style` string, required
    - `size` integer, required
    - `size_source` string, required
    - `mode` string, required
    - `kind` string: model (one object) or kit (a scene: modular tiles plus placed objects).
    - `error` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `inference_id` string
    - `versions` LowPolyVersionRead[]
      - `number` integer, required
      - `kind` string, required
      - `prompt` string
      - `created_at` string, date-time
      - `render_url` string, required
      - `turntable_url` string
      - `scene_url` string: Viewer payload (JSON) for the interactive 3D view.
      - `animations` string[]
      - `rigged` boolean
      - `stats` object
    - `active_task_id` string
  - `animation` string
  - `pieces` LowPolyAssetRead[]: split: the new models, one per object (each is also a new history item).
    - `asset_id` string, required
    - `status` string, required
    - `prompt` string
    - `style` string, required
    - `size` integer, required
    - `size_source` string, required
    - `mode` string, required
    - `kind` string: model (one object) or kit (a scene: modular tiles plus placed objects).
    - `error` string
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `inference_id` string
    - `versions` LowPolyVersionRead[]
      - `number` integer, required
      - `kind` string, required
      - `prompt` string
      - `created_at` string, date-time
      - `render_url` string, required
      - `turntable_url` string
      - `scene_url` string: Viewer payload (JSON) for the interactive 3D view.
      - `animations` string[]
      - `rigged` boolean
      - `stats` object
    - `active_task_id` string
  - `items` object: Scene edit / animate: each selected item's result ({'tile:<id>' | 'object:<id>': {status, error?}}); you pay only for the ones that worked.
  - `error` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `405`: Method not allowed.
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api.md) · [All operations](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/retrodiffusion/apis/retrodiffusion-api/revisions/9c76250e8e2d?raw)