## Initiate a dataset upload

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

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

Initiate a dataset upload

### Parameters

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

  Format of the file being uploaded

  - `"csv"`

  - `"json"`

  - `"jsonl"`

  - `"parquet"`

- `name: str`

  Human-readable name for the dataset

### Returns

- `class UploadInitiateResponse: …`

  - `upload_url: str`

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

### Example

```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)
```

#### Response

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