---
title: "Models - batch-fetch definitions"
method: POST
path: "/api/v1/models/definitions"
tags: ["Models"]
---

# Models - batch-fetch definitions

`POST /api/v1/models/definitions`

Returns parameter schemas and defaults for the requested model names.

## Request body

- DefinitionsBody — Fetch parameter definitions for one or more parametric models. Returns available parameters, types, defaults, and constraints.
  - `names` string[], required — Array of model slugs to fetch definitions for (e.g. ['dragon-cup', 'phone-nest'])

## Response `200`

Model definitions

- ModelBatchDefinitionsResponse — Success envelope containing multiple model definitions
  - `ok` true, required
  - `data` ModelBatchDefinitions, required — Definitions for multiple models in a single response
    - `definitions` object, required — Model definitions keyed by slug. Each contains parameter schemas and defaults.

## Other responses

- `400` — Validation error

## Changes

- **2026-04-30** `bef883f8a334` — 2 breaking, 19 info
  - the `names` request property's minItems was increased to `1`
  - the `names/items/` request property's minLength was increased from `0` to `1`
  - api operation id `batchModelDefinitions` removed and replaced with ``
  - added the non-success response with the status `400`
  - …17 more
- **2026-04-17** `5eb4ed0f33c7` — 16 breaking, 1 warning, 3 info
  - the response property `data` became optional for the status `200`
  - the response property `data/definitions` became optional for the status `200`
  - the response property `data/definitions/additionalProperties/defaults` became optional for the status `200`
  - the response property `data/definitions/additionalProperties/description` became optional for the status `200`
  - …16 more

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