---
title: "Bulk Soft-Delete Objects"
method: POST
path: "/v1/buckets/{bucket_identifier}/objects/bulk-soft-delete"
tags: ["Bucket Objects"]
---

# Bulk Soft-Delete Objects

`POST /v1/buckets/{bucket_identifier}/objects/bulk-soft-delete`

Soft-delete many objects by ID in one call (recoverable). Records are
    retained and flipped to a non-active lifecycle state (so retrieval excludes
    them), with the lifecycle propagated to downstream documents. Bucket stats
    are recomputed once. Designed for large purges (e.g. scoping a synced bucket
    to a subset) without the per-object webhook/stats storms of single delete.

## Path parameters

- `bucket_identifier` string, required — The unique identifier of the bucket.

## Request body

- BulkSoftDeleteRequest — Request model for bulk soft-deleting objects by id (recoverable purge).
  - `object_ids` string[], required — Object IDs to soft-delete (max 5000 per request). Records are retained and flipped to a non-active lifecycle state so retrieval excludes them; reversible by clearing the marker.
  - `reason` string, required — Why these objects are being soft-deleted (audit trail).
  - `lifecycle_state` string — Lifecycle state to flip to (default 'disabled').
  - `source` string — Marker source tag (default 'bulk_purge').

## Response `200`

Successful Response

- BulkSoftDeleteResponse — Response for a bulk soft-delete operation.
  - `soft_deleted` integer, required — Number of object records flipped.
  - `requested` integer, required — Number of object IDs requested.
  - `collections` integer, required — Collections sourced from the bucket considered for propagation.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/versions/04b379bdbb7c/schema)