v51

latestOpenAPI 3.1.0proprietaryraw.githubusercontent.com2026-07-21411711.1 MB
/datasets

Create a Dataset

Create a dataset by uploading a file. See 'Dataset Creation' for more information.

post/v1/datasets

Query parameters

namestring required

The name of the uploaded dataset.

type'embed-input' | 'embed-result' | 'cluster-result' | 'cluster-outliers' | 'reranker-finetune-input' | 'single-label-classification-finetune-input' | 'chat-finetune-input' | 'multi-label-classification-finetune-input' | 'batch-chat-input' | 'batch-openai-chat-input' | 'batch-embed-v2-input' | 'batch-chat-v2-input' required

The type of the dataset

The dataset type, which is used to validate the data. The only valid type is embed-input used in conjunction with the Embed Jobs API.

keep_original_fileboolean

Indicates if the original file should be stored.

skip_malformed_inputboolean

Indicates whether rows with malformed input should be dropped (instead of failing the validation check). Dropped rows will be returned in the warnings field.

keep_fieldsstring[]

List of names of fields that will be persisted in the Dataset. By default the Dataset will retain only the required fields indicated in the schema for the corresponding Dataset type. For example, datasets of type embed-input will drop all fields other than the required text field. If any of the fields in keep_fields are missing from the uploaded file, Dataset validation will fail.

optional_fieldsstring[]

List of names of fields that will be persisted in the Dataset. By default the Dataset will retain only the required fields indicated in the schema for the corresponding Dataset type. For example, Datasets of type embed-input will drop all fields other than the required text field. If any of the fields in optional_fields are missing from the uploaded file, Dataset validation will pass.

text_separatorstring

Raw .txt uploads will be split into entries using the text_separator value.

csv_delimiterstring

The delimiter used for .csv uploads.

Headers

X-Client-Namestring

The name of the project that is making the request.

Response

A successful response.

idstring

The dataset ID