---
title: "Upload an object"
method: PUT
path: "/worker/object/{key}"
tags: ["worker"]
---

# Upload an object

`PUT /worker/object/{key}`

Uploads an object to the Sia network.

## Path parameters

- `key` string, required

## Query parameters

- `bucket` string, required — The name of the bucket.
- `minshards` integer — The number of data shards a piece of an object gets erasure-coded into
- `totalshards` integer — The number of total data shards a piece of an object gets erasure-coded into
- `mimetype` string — The MIME type of the object

## Response `200`

Successfully uploaded object

## Other responses

- `400` — Invalid combination of request parameters
- `404` — Bucket not found
- `503` — Consensus isn't synced

## Changes

- **2025-01-23** `c38282599c5a` — 4 breaking, 2 warning
  - for the `query` request parameter `minshards`, default value `10` was added
  - for the `query` request parameter `totalshards`, default value `30` was added
  - for the `query` request parameter `minshards`, the type/format was changed from `integer`/`uint32` to `integer`/`uint8`
  - for the `query` request parameter `totalshards`, the type/format was changed from `integer`/`uint32` to `integer`/`uint8`
  - …2 more
- **2024-12-18** `922f156353c9` — 3 breaking, 1 info
  - removed the media type `text/plain` for the response with the status `400`
  - removed the media type `text/plain` for the response with the status `404`
  - removed the media type `text/plain` for the response with the status `503`
  - api tag `worker` added
- **2024-12-09** `2700783521b0` — 1 info
  - endpoint added
- **2024-12-09** `f062c35d8f47` — 1 breaking
  - api removed without deprecation

[Change history](https://skmtc.dev/siafoundation/apis/renterd-api/changes/worker/object/:key/put.md)

---

[API](https://skmtc.dev/siafoundation/apis/renterd-api.md) · [All operations](https://skmtc.dev/siafoundation/apis/renterd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/siafoundation/renterd-api/revisions/184a3d5207da/schema)