---
title: "Initiate a dataset upload"
method: POST
path: "/api/v1/datasets/upload/initiate"
tags: ["Dataset"]
---

# Initiate a dataset upload

`POST /api/v1/datasets/upload/initiate`

## Request

- The document declares no server URL.
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/adaptionlabs/apis/adaption-api/docs/api/v1/datasets/upload/initiate/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- InitiateDto
  - `name` string, required: Human-readable name for the dataset
  - `file_format` 'csv' | 'json' | 'jsonl' | 'parquet' | 'pdf' | 'docx' | 'pptx' | 'xlsx' | 'html' | 'zip' | 'txt', required: Format of the file being uploaded

## Response `default`

- InitiateResponseDto
  - `upload_url` string, required: Pre-signed S3 URL — upload the file directly to this URL via HTTP PUT

---

[API](https://skmtc.dev/adaptionlabs/apis/adaption-api.md) - [All operations](https://skmtc.dev/adaptionlabs/apis/adaption-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adaptionlabs/apis/adaption-api/revisions/d4cf908c19a0?raw)