## Initiate a dataset upload

**post** `/api/v1/datasets/upload/initiate`

Initiate a dataset upload

### Body Parameters

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

  Format of the file being uploaded

  - `"csv"`

  - `"json"`

  - `"jsonl"`

  - `"parquet"`

- `name: string`

  Human-readable name for the dataset

### Returns

- `upload_url: string`

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

### Example

```http
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"
        }'
```

#### Response

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