---
title: "Generate a parametric model"
method: POST
path: "/api/v1/models/{modelName}"
tags: ["Models"]
---

# Generate a parametric model

`POST /api/v1/models/{modelName}`

Submits a parametric model for generation. Returns **202 Accepted** with a task ID.

Poll `GET /api/v1/tasks/{taskId}` until `status` is `completed`, then fetch the result via `GET /api/v1/tasks/{taskId}/result/{format}`.

See the model-specific examples below. All model parameters are optional — defaults produce a valid model.

## Path parameters

- `modelName` string, required

## Request body

- ModelSubmission
  - `params` object — Model-specific parameters (all optional, defaults apply)
  - `outputs` OutputOptions, required
    - `formats` OutputFormat[], required — Output formats to generate
    - `meshPrecision` number — Mesh tessellation precision (lower = finer)
    - `gltfMeshPrecision` number — glTF-specific mesh deflection
    - `adjustYtoZ` boolean — Swap Y↔Z axis for mesh/glTF output

## Response `202`

Task accepted for processing

- SuccessResponseTaskCreated
  - `ok` true
  - `data` TaskCreatedResult
    - `taskId` string, uuid, required
    - `status` 'queued', required
    - `statusUrl` string, required

## Other responses

- `400` — Request validation failed
- `404` — Resource not found

## Changes

- **2026-04-17** `5eb4ed0f33c7` — 8 breaking, 4 warning, 4 info
  - the `outputs/gltfMeshPrecision` request property's min was increased to `0.01`
  - the `outputs/meshPrecision` request property's min was increased to `0.01`
  - the response property `data` became optional for the status `202`
  - the response property `ok` became optional for the status `202`
  - …12 more

[Change history](https://skmtc.dev/bitbybit-dev/apis/bitbybit-cad-cloud-api/changes/api/v1/models/:modelName/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/5eb4ed0f33c7/schema)