---
title: "Creates a new model."
method: POST
path: "/models"
tags: ["Custom Speech models:"]
---

# Creates a new model.

`POST /models`

## Request body

- CustomModel
  - `self` string, uri — The location of this entity.
  - `locale` string, required — The locale of the contained data.
  - `displayName` string, required — The display name of the object.
  - `description` string — The description of the object.
  - `lastActionDateTime` string, date-time — The time-stamp when the current status was entered. The time stamp is encoded as ISO 8601 date and time format ("YYYY-MM-DDThh:mm:ssZ", see https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
  - `status` 'NotStarted' | 'Running' | 'Succeeded' | 'Failed' — Describe the current state of the API
  - `createdDateTime` string, date-time — The time-stamp when the object was created. The time stamp is encoded as ISO 8601 date and time format ("YYYY-MM-DDThh:mm:ssZ", see https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

## Response `201`

The response contains information about the entity as payload and its location as header.

- CustomModel
  - `self` string, uri — The location of this entity.
  - `locale` string, required — The locale of the contained data.
  - `displayName` string, required — The display name of the object.
  - `description` string — The description of the object.
  - `lastActionDateTime` string, date-time — The time-stamp when the current status was entered. The time stamp is encoded as ISO 8601 date and time format ("YYYY-MM-DDThh:mm:ssZ", see https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).
  - `status` 'NotStarted' | 'Running' | 'Succeeded' | 'Failed' — Describe the current state of the API
  - `createdDateTime` string, date-time — The time-stamp when the object was created. The time stamp is encoded as ISO 8601 date and time format ("YYYY-MM-DDThh:mm:ssZ", see https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations).

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/azure/apis/cognitiveservices-speech-speechtotext.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-speech-speechtotext/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-speech-speechtotext/versions/931821089e0d/schema)