API Reference

Datasets

Upload

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Initiate a dataset upload

POST/api/v1/datasets/upload/initiate

Initiate a dataset upload

Body ParametersJSONExpand Collapse

file_format: "csv" or "json" or "jsonl" or "parquet"

Format of the file being uploaded

One of the following:

"csv"

"json"

"jsonl"

"parquet"

name: string

Human-readable name for the dataset

ReturnsExpand Collapse

upload_url: string

Pre-signed S3 URL — upload the file directly to this URL via HTTP PUT

Initiate a dataset upload

HTTP

HTTP

TypeScript

Python

curl https://api.adaptionlabs.ai/api/v1/datasets/upload/initiate \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $ADAPTION_API_KEY" \
    -d '{
          "file_format": "csv",
          "name": "my-training-data"
        }'

200 example

{
  "upload_url": "https://s3.amazonaws.com/bucket/key?X-Amz-Signature=..."
}

Returns Examples

200 example

{
  "upload_url": "https://s3.amazonaws.com/bucket/key?X-Amz-Signature=..."
}