API Reference

Datasets

Upload

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Initiate a dataset upload

datasets.upload.initiate(UploadInitiateParams**kwargs) -> UploadInitiateResponse

POST/api/v1/datasets/upload/initiate

Initiate a dataset upload

ParametersExpand Collapse

file_format: Literal["csv", "json", "jsonl", "parquet"]

Format of the file being uploaded

One of the following:

"csv"

"json"

"jsonl"

"parquet"

name: str

Human-readable name for the dataset

ReturnsExpand Collapse

class UploadInitiateResponse: …

upload_url: str

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

Initiate a dataset upload

Python

HTTP

TypeScript

Python

import os
from adaption import Adaption

client = Adaption(
    api_key=os.environ.get("ADAPTION_API_KEY"),  # This is the default and can be omitted
)
response = client.datasets.upload.initiate(
    file_format="csv",
    name="my-training-data",
)
print(response.upload_url)

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=..."
}