Skip to main content
POST
Python
You can upload one of the following types of datasets:
  • SINGLE_FILE: exactly one file containing all the samples
  • MULTI_FILE: multiple files, where each file is a separate sample
  • MULTI_FOLDER: multiple folders, where each folder is a separate sample and only contains files with no nested folders

File constraints by dataset type

Authorizations

Authorization
string
header
required

API Key authentication. Format: "Bearer YOUR_API_KEY"

Body

multipart/form-data
name
string
required

Dataset name (must be unique)

dataset_type
enum<string>
required
Available options:
SINGLE_FILE,
MULTI_FILE,
MULTI_FOLDER
files
file[]
required

Files to upload. SINGLE_FILE: exactly 1 file. MULTI_FILE: 2+ files. MULTI_FOLDER: 2+ files with corresponding folder_names.

Minimum array length: 2
description
string

Optional dataset description

folder_names
string[]

Folder names for MULTI_FOLDER datasets. This is a parallel array with files: folder_names[i] specifies which folder files[i] belongs to (e.g., if files=['a.txt', 'b.txt'] and folder_names=['doc1', 'doc2'], then a.txt goes in doc1, b.txt goes in doc2). Minimum 2 unique folder names required. For MULTI_FOLDER, file order within each folder is preserved as uploaded — earlier files should be the ones that later files may depend on.

Minimum array length: 2

Response

Seed dataset created successfully

id
string<uuid>
read-only

Unique identifier for the dataset

name
string

Dataset name

description
string | null

Optional description of the dataset contents or purpose

dataset_type
enum<string>

Type of dataset structure. SINGLE_FILE: one CSV/JSON/JSONL file with tabular data. MULTI_FILE: multiple individual text files. MULTI_FOLDER: files organized into folders where each folder represents one sample.

Available options:
SINGLE_FILE,
MULTI_FILE,
MULTI_FOLDER
created_at
string<date-time>
read-only

Timestamp when the dataset was created

updated_at
string<date-time>
read-only

Timestamp when the dataset was last modified

created_by_email
string
read-only

Email address of the user who created the dataset

files
object[]
read-only

List of all files in the dataset

folder_count
integer
read-only

Total number of folders in the dataset

file_count
integer
read-only

Total number of files in the dataset

sample_count
integer | null
read-only

Number of data samples in the dataset. Only populated for SINGLE_FILE datasets (e.g. number of rows in a CSV).