---
title: "Upload Reserved Dataset Content"
method: PUT
path: "/v1/datasets/upload/{dataset_id}/content"
tags: ["datasets"]
---

# Upload Reserved Dataset Content

`PUT /v1/datasets/upload/{dataset_id}/content`

## Request

- Base URL: `https://api.pioneer.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pioneer.ai/v1/datasets/upload/{dataset_id}/content`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/pioneer/apis/brain-api/docs/v1/datasets/upload/:dataset_id/content/put.ts> (a function with typed inputs; its response is checked against the schema)

Streams raw upload bytes to a reservation's S3 key for the caller.

The body is consumed as it arrives rather than read into memory, so a
dataset of any size costs one multipart part of resident memory.

Args:
    dataset_id: Reservation returned by ``POST /felix/datasets/upload/url``.
    http_request: Carries the raw file bytes as the request body.
    auth: Authenticated caller, who must own the reservation.

Returns:
    A receipt naming the reservation and the byte count stored.

Raises:
    HTTPException: 404, 409, 400, or 413 per :data:`_REFUSAL_RESPONSES`.

## Path parameters

- `dataset_id` string, required

## Response `200`

Successful Response

- DatasetUploadContentResponse: Receipt for raw upload bytes the Brain wrote to S3 for the caller.
  - `dataset_id` string, required: Dataset ID the bytes were stored against
  - `version_number` string, required: Version number of that dataset
  - `bytes_received` integer, required: Number of bytes stored

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-24** `0e5e86e2bae5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/pioneer/apis/brain-api/changes/v1/datasets/upload/:dataset_id/content/put.md)

---

[API](https://skmtc.dev/pioneer/apis/brain-api.md) - [All operations](https://skmtc.dev/pioneer/apis/brain-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pioneer/apis/brain-api/revisions/0e5e86e2bae5?raw)