---
title: "Uploads and creates a new dataset by getting the data from a specified URL or starts waiting for data blocks to be uploaded."
method: POST
path: "/datasets"
tags: ["Custom Speech datasets for model adaptation:"]
---

# Uploads and creates a new dataset by getting the data from a specified URL or starts waiting for data blocks to be uploaded.

`POST /datasets`

## Request body

- Dataset
  - `links` DatasetLinks
    - `files` string, uri — The location to get all files of this entity. See operation "Datasets_ListFiles" for more details.
    - `commitBlocks` string, uri — The location to commit the list of blocks when uploading a dataset using blocks. See operation "Datasets_CommitBlocks" for more details.
    - `listBlocks` string, uri — The location to list the already uploaded blocks of this entity when uploading a dataset using blocks. See operation "Datasets_GetBlocks" for more details.
    - `uploadBlocks` string, uri — The location to upload blocks to when uploading a dataset using blocks. See operation "Datasets_UploadBlock" for more details.
  - `properties` DatasetProperties
    - `textNormalizationKind` 'Default' | 'None' — The kind of text normalization.
    - `acceptedLineCount` integer — The number of lines accepted for this data set.
    - `rejectedLineCount` integer — The number of lines rejected for this data set.
    - `duration` string — The total duration of the datasets if it contains audio files. The duration is encoded as ISO 8601 duration ("PnYnMnDTnHnMnS", see https://en.wikipedia.org/wiki/ISO_8601#Durations).
    - `email` string — The email address to send email notifications to in case the operation completes. The value will be removed after successfully sending the email.
    - `error` EntityError
      - `code` string — The code of this error.
      - `message` string — The message for this error.
  - `kind` 'Language' | 'Acoustic' | 'Pronunciation' | 'AudioFiles' | 'LanguageMarkdown' | 'OutputFormatting', required — Type of data import.
  - `self` string, uri — The location of this entity.
  - `displayName` string, required — The display name of the object.
  - `description` string — The description of the object.
  - `contentUrl` string, uri — The URL of the data for the dataset.
  - `customProperties` object — The custom properties of this entity. The maximum allowed key length is 64 characters, the maximum allowed value length is 256 characters and the count of allowed entries is 10.
  - `locale` string, required — The locale of the contained data.
  - `project` EntityReference
    - `self` string, uri, required — The location of the referenced entity.
  - `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.

- Dataset
  - `links` DatasetLinks
    - `files` string, uri — The location to get all files of this entity. See operation "Datasets_ListFiles" for more details.
    - `commitBlocks` string, uri — The location to commit the list of blocks when uploading a dataset using blocks. See operation "Datasets_CommitBlocks" for more details.
    - `listBlocks` string, uri — The location to list the already uploaded blocks of this entity when uploading a dataset using blocks. See operation "Datasets_GetBlocks" for more details.
    - `uploadBlocks` string, uri — The location to upload blocks to when uploading a dataset using blocks. See operation "Datasets_UploadBlock" for more details.
  - `properties` DatasetProperties
    - `textNormalizationKind` 'Default' | 'None' — The kind of text normalization.
    - `acceptedLineCount` integer — The number of lines accepted for this data set.
    - `rejectedLineCount` integer — The number of lines rejected for this data set.
    - `duration` string — The total duration of the datasets if it contains audio files. The duration is encoded as ISO 8601 duration ("PnYnMnDTnHnMnS", see https://en.wikipedia.org/wiki/ISO_8601#Durations).
    - `email` string — The email address to send email notifications to in case the operation completes. The value will be removed after successfully sending the email.
    - `error` EntityError
      - `code` string — The code of this error.
      - `message` string — The message for this error.
  - `kind` 'Language' | 'Acoustic' | 'Pronunciation' | 'AudioFiles' | 'LanguageMarkdown' | 'OutputFormatting', required — Type of data import.
  - `self` string, uri — The location of this entity.
  - `displayName` string, required — The display name of the object.
  - `description` string — The description of the object.
  - `contentUrl` string, uri — The URL of the data for the dataset.
  - `customProperties` object — The custom properties of this entity. The maximum allowed key length is 64 characters, the maximum allowed value length is 256 characters and the count of allowed entries is 10.
  - `locale` string, required — The locale of the contained data.
  - `project` EntityReference
    - `self` string, uri, required — The location of the referenced entity.
  - `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)