---
title: "CAD - execute a single operation"
method: POST
path: "/api/v1/cad/execute"
tags: ["CAD Operations"]
---

# CAD - execute a single operation

`POST /api/v1/cad/execute`

Runs a single CAD operation by its fully-qualified identifier.

## Request body

- ExecuteBody — Execute a single Bitbybit CAD operation. The operation runs asynchronously and returns a task ID for polling.
  - `operation` string, required — Fully-qualified CAD operation identifier (e.g. 'occt.shapes.solid.createBox', 'manifold.primitives.cube', 'jscad.booleans.union'). Supports OCCT, Manifold, JSCAD, and vector/math operations.
  - `params` unknown

## Response `202`

Task accepted

- TaskAcceptedResponse — HTTP 202 response when a task is accepted for async processing
  - `ok` true, required
  - `data` TaskCreatedResult, required — Returned when a CAD task is accepted. Poll the statusUrl to track progress.
    - `taskId` string, uuid, required — Unique task identifier - use this to poll for status and retrieve results
    - `status` 'queued', required — Initial task status (always 'queued' upon creation)
    - `statusUrl` string, required — Relative URL to poll for task status updates

## Other responses

- `400` — Validation error
- `500` — Server error

## Changes

- **2026-05-04** `43c3bc84d7c1` — 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `202`
- **2026-04-30** `bef883f8a334` — 3 breaking, 7 info
  - the `operation` request property's minLength was increased from `0` to `1`
  - the `params` request property type/format changed from `object`/`` to ``/``
  - removed the success response with the status `202`
  - api operation id `cadExecute` removed and replaced with ``
  - …6 more
- **2026-04-17** `5eb4ed0f33c7` — 6 breaking, 3 warning, 5 info
  - the `params` request property type/format changed from ``/`` to `object`/``
  - the response property `data` became optional for the status `202`
  - the response property `ok` became optional for the status `202`
  - the `ok` response property const value `false` was removed for the status `400`
  - …10 more

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