Sign in
latestOpenAPI 3.1.02026-07-2675394318.9 KB

0fb323abba3c

datasets

Create a dataset by uploading data

Create a dataset

post/v1/datasets

Request body

OR

Example request

{
  "name": "example_dataset",
  "folder": "/some/folder",
  "ai_project_id": "example_project"
}

Response

Successful Response

idstring required

The object identifier, which can be referenced in the API endpoints.

namestring required

ID of the dataset.

status'READY' | 'PENDING' | 'FAILED' | 'TEMPORARY' | 'DRAFT' required
metadataobject required

Additional metadata associated with the dataset.

folderstring required

Folder path where the dataset is stored.

current_versionstring required

Current version of the dataset.

created_atinteger required

Unix timestamp when the dataset was created.

errorstring nullable required

Error message if the dataset is in an error state.

ai_project_idstring nullable

AI Studio project ID to associate with the dataset.

Example response

{
  "id": "4d89c87498354518b92fa02fc0ad8720",
  "name": "example_dataset",
  "metadata": {},
  "folder": "/some/folder",
  "current_version": "0ed2d94b38fb40b9b61f6a",
  "created_at": 1760109124,
  "ai_project_id": "example_project"
}