---
title: "POST /models/{modelId}/trainings"
method: POST
path: "/models/{modelId}/trainings"
---

# POST /models/{modelId}/trainings

`POST /models/{modelId}/trainings`

## Path parameters

- `modelId` string, required

## Headers

- `Content-Type` string, required

## Request body

- PostTrainings
  - `dataBundleIds` string[]
  - `dataScientistAssistance` boolean
  - `description` string, nullable
  - `instanceType` 'small-gpu' | 'medium-gpu' | 'large-gpu', nullable
  - `metadata` object
  - `name` string, nullable
  - `warmStartConfig` object
    - `trainingId` string, required

## Response `200`

200 response

- Training
  - `createdBy` string, nullable, required
  - `createdTime` string, nullable, required
  - `dataBundleIds` string[], required
  - `dataScientistAssistance` boolean
  - `deploymentEnvironmentId` string, nullable
  - `description` string, nullable, required
  - `evaluation` object, required
  - `gpuHours` number, nullable, required
  - `instanceType` 'small-gpu' | 'medium-gpu' | 'large-gpu', required
  - `metadata` object, nullable, required
  - `modelId` string, required
  - `name` string, nullable, required
  - `statistics` object, nullable
  - `status` 'waiting-for-approval' | 'preparing' | 'pending' | 'running' | 'running-final-evaluation' | 'succeeded' | 'failed' | 'cancelled', required
  - `trainingId` string, required
  - `updatedBy` string, nullable, required
  - `updatedTime` string, nullable, required
  - `warmStartConfig` union
    - object
      - `trainingId` string, required
    - object

## Other responses

- `400` — 400 response
- `403` — 403 response
- `404` — 404 response
- `415` — 415 response
- `500` — 500 response

## Changes

- **2026-07-13** `d5fe190026be` — 2 warning, 3 info
  - changed the pattern of the request property `warmStartConfig/trainingId` from `^las:model-training:[a-f0-9]{32}$` to `^las:model-training:[a-z0-9-_]+$`
  - added the new `preparing` enum value to the `status` response property for the response status `200`
  - added the optional property `statistics` to the response with the `200` status
  - the `trainingId` response's property pattern was changed from `^las:model-training:[a-f0-9]{32}$` to `^las:model-training:[a-z0-9-_]+$` for the status `200`
  - …1 more
- **2023-06-07** `066fc828de83` — 1 warning
  - added the new `running-final-evaluation` enum value to the `status` response property for the response status `200`
- **2023-02-14** `1cd1234c5271` — 1 info
  - the `modelId` response's property pattern was changed from `^las:model:[a-f0-9]{32}$` to `^las:model:[a-z0-9-_]+$` for the status `200`
- **2023-01-03** `b97c0a72def1` — 2 info
  - added the new optional request property `warmStartConfig`
  - added the optional property `warmStartConfig` to the response with the `200` status
- **2022-09-29** `424af607ab69` — 2 breaking
  - the response property `gpuHours` became nullable for the status `200`
  - the response property `metadata` became nullable for the status `200`

[Full history](https://skmtc.dev/lucidtechai/apis/lucidtech-api/changes/models/:modelId/trainings/post.md)

---

[API](https://skmtc.dev/lucidtechai/apis/lucidtech-api.md) · [All operations](https://skmtc.dev/lucidtechai/apis/lucidtech-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/lucidtechai/lucidtech-api/revisions/d5fe190026be/schema)