---
title: "Start a multipart upload (Pro/Max, files over 100 MB)"
method: POST
path: "/api/v1/uploads"
---

# Start a multipart upload (Pro/Max, files over 100 MB)

`POST /api/v1/uploads`

## Request

- Base URL: `https://rows.page`
- URL: `https://rows.page/api/v1/uploads`
- Auth: HTTP bearer

## Query parameters

- `format` 'csv' | 'tsv' | 'json' | 'jsonl' | 'ndjson' | 'parquet'
- `name` string
- `title` string
- `summary` string
- `key` string
- `id_column` string
- `dataset` string
- `source` string
- `run` string
- `commit` string
- `visibility` 'public' | 'private'

## Request body

- object
  - `bytes` integer: Total size, checked against the plan cap

## Response `201`

Created

- object
  - `upload_id` string
  - `dataset_id` string
  - `part_bytes` integer
  - `max_bytes` integer
  - `part_url` string
  - `complete_url` string

## Other responses

- `400`: Error
- `401`: Error
- `402`: Error
- `413`: Error

---

[API](https://skmtc.dev/rows/apis/rows-page-api.md) · [All operations](https://skmtc.dev/rows/apis/rows-page-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rows/apis/rows-page-api/revisions/98dacb9eeca7?raw)