---
title: "Create Upload"
method: POST
path: "/v2/uploads"
tags: ["uploads"]
---

# Create Upload

`POST /v2/uploads`

Reserve a staged upload for a taskset and return the presigned PUT that receives it.

## Query parameters

- `taskset_id` string, uuid, required — Taskset the upload is attached to

## Request body

- StagedUploadCreateRequest — Reserve a pending upload slot for the declared payload. The declared type and size are bound into the presigned PUT(s); the bytes themselves are validated at completion.
  - `content_type` string, required
  - `size_bytes` integer, required

## Response `200`

Successful Response

- union
  - StagedUploadSingleResponse — A reserved single-request upload. PUT the file bytes to ``upload_url`` with exactly the declared ``Content-Type`` and ``Content-Length`` (both are part of the signature), then call the complete endpoint with ``upload_id``.
    - `mode` 'single', required
    - `upload_id` string, uuid, required
    - `upload_url` string, required
  - StagedUploadMultipartResponse — A reserved multipart upload. Slice the file into ``part_size`` chunks (the last part may be short), PUT each slice to its part's ``upload_url`` — in parallel if desired — and collect each response's ``ETag`` header. Then call the complete endpoint with ``upload_id``, ``s3_upload_id``, and the part/ETag pairs.
    - `mode` 'multipart', required
    - `upload_id` string, uuid, required
    - `s3_upload_id` string, required
    - `part_size` integer, required
    - `parts` StagedUploadPartTarget[], required
      - `part_number` integer, required
      - `upload_url` string, required
      - `size_bytes` integer, required

## Other responses

- `400` — Invalid or malformed request
- `401` — Missing or invalid credentials
- `403` — Caller may not access this resource
- `404` — Referenced entity does not exist
- `409` — Resource already exists
- `422` — Validation Error

---

[API](https://skmtc.dev/hud/apis/hud-platform.md) · [All operations](https://skmtc.dev/hud/apis/hud-platform/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hud/hud-platform/revisions/58558fc733d9/schema)