---
title: "Changes to Get Upload Url"
method: POST
path: "/v1/datasets/upload/url"
---

# Changes to Get Upload Url

`POST /v1/datasets/upload/url`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 5 of 24 revisions.

- **2026-10-17** `81465e18c1d2`: 1 breaking, 1 warning, 2 info
- **2026-10-15** `ef285860f952`: 4 info
- **2026-10-12** `43d7e06a824b`: 1 breaking
- **2026-09-28** `54da122a2879`: 1 info
- **2026-09-24** `ce8c49a7bd79`: 1 info

## Changes

- **2026-10-17** `81465e18c1d2`: 1 breaking, 1 warning, 2 info
  - request property `visibility/anyOf[subschema #1]/` was restricted to a list of enum values
  - the `dataset_name` request property's maxLength was set to `128`
  - added the new `private` enum value to the request property `visibility/anyOf[subschema #1]/`
  - added the new `public` enum value to the request property `visibility/anyOf[subschema #1]/`
- **2026-10-15** `ef285860f952`: 4 info
  - added the new optional request property `content_length`
  - added the new optional request property `sha256`
  - the `upload_instructions` response's property default value changed from `Upload file via HTTP PUT to presigned_url, then call /datasets/upload/process with dataset_id, format, and schema (if applicable)` to `PUT the raw file bytes to presigned_url and send every header in upload_headers with exactly its value: always Content-Type: application/octet-stream, plus Content-Length and x-amz-checksum-sha256 when listed. A missing or different header is refused with 403. Then call POST /datasets/upload/process with dataset_id.` for the status `200`
  - added the required property `upload_headers` to the response with the `200` status
- **2026-10-12** `43d7e06a824b`: 1 breaking
  - the `dataset_name` request property's minLength was increased from `0` to `1`
- **2026-09-28** `54da122a2879`: 1 info
  - api operation id `get_upload_url_datasets_upload_url_post` removed and replaced with `get_upload_url_v1_datasets_upload_url_post`
- **2026-09-24** `ce8c49a7bd79`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/fastino-ai/apis/pioneer-inference-api/docs/v1/datasets/upload/url/post.md) - [API](https://skmtc.dev/fastino-ai/apis/pioneer-inference-api.md) - [Page](https://skmtc.dev/fastino-ai/apis/pioneer-inference-api/changes/v1/datasets/upload/url/post)