---
title: "Request a new upload"
method: POST
path: "/s3/requestDatasetUpload"
tags: ["s3upload"]
---

# Request a new upload

`POST /s3/requestDatasetUpload`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/s3/requestDatasetUpload`
- Auth: HTTP bearer

## Request body

- UploadRequestBody
  - `dataset_id` string, required
  - `dataset_size_gib` integer, required

## Response `201`

Upload request successful

- UploadRequestSuccessfulResp
  - `message` string, required

## Other responses

- `422`: Validation Error
- `500`: Internal Server Error
- `507`: Upload request unsuccessful

## Changes

> 17 revisions in range; 4 not diffed.

- **2025-11-21** `527aef2c43cd`: 3 breaking, 2 warning, 2 info
  - added the new required request property `dataset_id`
  - added the new required request property `dataset_size_gib`
  - removed the required property `Ok` from the response with the `201` status
  - removed the request property `DatasetPID`
  - …3 more
- **2025-11-17** `c2c75bdb1338`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/swissopenem/apis/ethz-archiver-service/changes/s3/requestDatasetUpload/post.md)

---

[API](https://skmtc.dev/swissopenem/apis/ethz-archiver-service.md) - [All operations](https://skmtc.dev/swissopenem/apis/ethz-archiver-service/llms.txt) - [OpenAPI document](https://skmtc.dev/swissopenem/apis/ethz-archiver-service/revisions/527aef2c43cd?raw)