Skip to main content
POST
/
datasets
/
{id}
/
files
cURL
curl --request POST \
  --url https://api.cartesia.ai/datasets/{id}/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Cartesia-Version: <cartesia-version>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file' \
  --form purpose=fine_tune

Documentation Index

Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

Headers

​
Cartesia-Version
enum<string>
required

API version header.

Available options:
2024-06-10,
2024-11-13,
2025-04-16,
2026-03-01
Example:

"2026-03-01"

Path Parameters

​
id
string
required

ID of the dataset to upload to

Body

multipart/form-data
​
file
file
​
purpose
string

Purpose of the file

Example:

"fine_tune"

Response

204 - undefined