Skip to main content
POST
Create a dataset by uploading data

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required

ID of the dataset.

Example:

"example_dataset"

schema
ColumnSchema · object[]
required

Dataset schema definition.

Examples:
folder
string
required

Folder path where the dataset is stored.

Example:

"/some/folder"

rows
Rows · object[]
required

List of rows to be included in the dataset.

Example:
ai_project_id
string | null

AI Studio project ID to associate with the dataset.

Example:

"example_project"

Response

Successful Response

id
string
required

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

Example:

"4d89c87498354518b92fa02fc0ad8720"

name
string
required

ID of the dataset.

Example:

"example_dataset"

status
enum<string>
required

Current status of the dataset.

Available options:
READY,
PENDING,
FAILED,
TEMPORARY,
DRAFT
Examples:

"READY"

"FAILED"

"PENDING"

schema
ColumnSchema · object[]
required

Dataset schema definition.

Examples:
metadata
Metadata · object
required

Additional metadata associated with the dataset.

Example:
folder
string
required

Folder path where the dataset is stored.

Example:

"/some/folder"

current_version
string
required

Current version of the dataset.

Example:

"0ed2d94b38fb40b9b61f6a"

created_at
integer
required

Unix timestamp when the dataset was created.

Example:

1760109124

error
string | null
required

Error message if the dataset is in an error state.

current_version_origin
DatasetOriginResponse · object | null

Origin information for the current dataset version. This object is extensible for source-specific fields.

Example:
ai_project_id
string | null

AI Studio project ID to associate with the dataset.

Example:

"example_project"