Skip to main content
POST
/
v1
/
datasets
/
upload
curl -X POST "https://api.destined.ai/v1/datasets/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@dataset.csv" \
  -F "name=My Dataset" \
  -F "generate_audio=true"

{
  "dataset_id": "ds_abc123",
  "name": "My Dataset",
  "row_count": 150,
  "job_id": "job_xyz789",
  "created_at": "2024-01-15T10:30:00Z"
}

​
Request

Upload a CSV file with multipart/form-data:
​
file
file
required
CSV file with columns: text, speaker_id (optional)
​
name
string
required
Name for this dataset
​
generate_audio
boolean
default:"false"
Automatically start TTS generation after upload

​
CSV Format

text,speaker_id
"Hello, this is the first sentence.",speaker-1
"This is another sentence to synthesize.",speaker-2
"Third example text here.",
If speaker_id is empty, a random speaker will be assigned.

​
Response

​
dataset_id
string
required
Unique dataset identifier
​
name
string
required
Dataset name
​
row_count
integer
required
Number of rows in the dataset
​
job_id
string
Job ID if generate_audio was true
curl -X POST "https://api.destined.ai/v1/datasets/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@dataset.csv" \
  -F "name=My Dataset" \
  -F "generate_audio=true"

{
  "dataset_id": "ds_abc123",
  "name": "My Dataset",
  "row_count": 150,
  "job_id": "job_xyz789",
  "created_at": "2024-01-15T10:30:00Z"
}