---
title: "Tasks - get result in a specific format"
method: GET
path: "/api/v1/tasks/{taskId}/result/{format}"
tags: ["Tasks"]
---

# Tasks - get result in a specific format

`GET /api/v1/tasks/{taskId}/result/{format}`

Returns a download URL for the requested output format (e.g. glb, step, stpz).

## Path parameters

- `taskId` string, uuid, required
- `format` string, required

## Response `200`

Result download link

- TaskResultResponse — Success envelope containing a download link for a task result
  - `ok` true, required
  - `data` TaskResultDownload, required — Download information for a completed task result
    - `downloadUrl` string, uri, required — Pre-signed URL to download the result file. Expires after 1 hour.
    - `filename` string, required — Suggested filename for the download

## Other responses

- `404` — Not found
- `409` — Task is not yet completed

## Changes

- **2026-04-30** `bef883f8a334` — 5 breaking, 8 info
  - removed the enum value `decomposed-mesh` from the `path` request parameter `format`
  - removed the enum value `glb` from the `path` request parameter `format`
  - removed the enum value `metadata` from the `path` request parameter `format`
  - removed the enum value `step` from the `path` request parameter `format`
  - …9 more
- **2026-04-17** `5eb4ed0f33c7` — 5 breaking, 2 warning, 7 info
  - the `path` request parameter `format` was restricted to a list of enum values
  - the response property `data` became optional for the status `200`
  - the response property `ok` became optional for the status `200`
  - the `ok` response property const value `false` was removed for the status `404`
  - …10 more

[Change history](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api/changes/api/v1/tasks/:taskId/result/:format/get.md)

---

[API](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api.md) · [All operations](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitbybit-dev/bitbybit-cad-cloud-api/revisions/1135d4473bc2/schema)