---
title: "Tasks - get result (default format)"
method: GET
path: "/api/v1/tasks/{taskId}/result"
tags: ["Tasks"]
---

# Tasks - get result (default format)

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

Returns a download URL for the task's primary result. For compound tasks, returns a manifest with per-sub-task download links.

## Path parameters

- `taskId` string, uuid, required

## Response `200`

Result download link (standard) or compound manifest

- union — Result download link for standard tasks, or a compound manifest with per-sub-task download links
  - 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
  - CompoundResultManifestResponse — Success envelope containing the compound task result manifest with per-sub-task download links
    - `ok` true, required
    - `data` CompoundResultManifest, required — Result manifest for a completed compound task
      - `manifest` CompoundResultEntry[], required — Per-sub-task status and download links
        - `taskId` string, required — Sub-task ID
        - `index` integer, required — Position in the compound task
        - `status` 'waiting' | 'queued' | 'processing' | 'completed' | 'failed' | 'cancelled' | 'expired', required — Task lifecycle state: waiting (pending dependencies), queued (in queue), processing (actively computing), completed (result available), failed (error occurred), cancelled (user-cancelled), expired (result TTL exceeded)
        - `downloadUrls` object — Download URLs keyed by format (only if completed)

## Other responses

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

## Changes

- **2026-04-30** `bef883f8a334` — 1 breaking, 2 warning, 5 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `ok` from the response with the `200` status
  - api operation id `getTaskResult` removed and replaced with ``
  - …4 more
- **2026-04-17** `5eb4ed0f33c7` — 2 breaking, 1 warning, 5 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
  - the `ok` response property const value `false` was removed for the status `404`
  - added the new `false` enum value to the `ok` response property for the response status `404`
  - api operation id `getTaskResult` was added
  - …4 more

[Change history](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api/changes/api/v1/tasks/:taskId/result/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)