---
title: "Changes to Delete a batch of objects with a given prefix"
method: POST
path: "/worker/objects/remove"
---

# Changes to Delete a batch of objects with a given prefix

`POST /worker/objects/remove`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 7 of 50 revisions.

- **2025-01-23** `c38282599c5a` — 2 breaking, 1 info
- **2024-12-18** `922f156353c9` — 2 breaking, 1 info
- **2024-12-12** `be2f724d7cd4` — 1 breaking
- **2024-12-12** `1a4b05c71ba9` — 1 breaking, 1 warning
- **2024-12-09** `9bd8635d818c` — 2 breaking, 1 info
- **2024-12-09** `2700783521b0` — 1 info
- **2024-12-09** `f062c35d8f47` — 1 breaking

## Changes

- **2025-01-23** `c38282599c5a` — 2 breaking, 1 info
  - added `#/components/schemas/ObjectKey, subschema #2` to the `prefix` request property `allOf` list
  - the `prefix` request property type/format changed from `string`/`` to ``/``
  - the `prefix` request property's minLength was decreased from `1` to `0`
- **2024-12-18** `922f156353c9` — 2 breaking, 1 info
  - 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 `500`
  - api tag `worker` added
- **2024-12-12** `be2f724d7cd4` — 1 breaking
  - removed the media type `text/plain` for the response with the status `200`
- **2024-12-12** `1a4b05c71ba9` — 1 breaking, 1 warning
  - added `#/components/schemas/BucketName` to the `bucket` request property `allOf` list
  - removed `#/components/schemas/Bucket` from the `bucket` request property `allOf` list
- **2024-12-09** `9bd8635d818c` — 2 breaking, 1 info
  - added `#/components/schemas/Bucket, subschema #2` to the `bucket` request property `allOf` list
  - the `bucket` request property type/format changed from `string`/`` to ``/``
  - removed the pattern `(?!(^xn--|.+-s3alias$))^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$` from the request property `bucket`
- **2024-12-09** `2700783521b0` — 1 info
  - endpoint added
- **2024-12-09** `f062c35d8f47` — 1 breaking
  - api path removed without deprecation

---

[Operation](https://skmtc.dev/siafoundation/apis/renterd-api/docs/worker/objects/remove/post.md) · [API](https://skmtc.dev/siafoundation/apis/renterd-api.md) · [Page](https://skmtc.dev/siafoundation/apis/renterd-api/changes/worker/objects/remove/post)