---
title: "Bulk delete documents"
method: DELETE
path: "/v3/documents/bulk"
tags: ["Ingest"]
---

# Bulk delete documents

`DELETE /v3/documents/bulk`

Bulk delete documents by IDs or container tags

## Request body

- object — Request body for bulk deleting documents by IDs or container tags
  - `ids` string[] — Array of document IDs to delete (max 100 at once)
  - `containerTags` string[] — Array of container tags - all documents in these containers will be deleted
  - `filepath` string — Delete documents matching this filepath. Exact match for full paths, prefix match if ending with /

## Response `200`

Bulk deletion completed successfully

- object — Response for bulk document deletion
  - `success` boolean, required — Whether the bulk deletion was successful
  - `deletedCount` number, required — Number of documents successfully deleted
  - `errors` object[] — Array of errors for documents that couldn't be deleted (only applicable when deleting by IDs)
    - `id` string, required
    - `error` string, required
  - `containerTags` string[] — Container tags that were processed (only applicable when deleting by container tags)

## Other responses

- `400` — Bad request - either 'ids' or 'containerTags' must be provided
- `401` — Unauthorized
- `500` — Internal server error

## Changes

- **2026-04-17** `f09b91ede978` — 1 info
  - added the new optional request property `filepath`
- **2026-04-06** `cb825424a780` — 2 info
  - api tag `Ingest` added
  - api tag `Manage Documents` removed
- **2026-03-15** `b40318167017` — 1 breaking
  - request body became required
- **2026-03-12** `7386f0fb8043` — 1 warning
  - changed the pattern of the request property `containerTags/items/` from `^[a-zA-Z0-9_-]+$` to `^[a-zA-Z0-9_:-]+$`
- **2026-03-09** `8d6903994bad` — 1 breaking, 1 warning
  - added the pattern `^[a-zA-Z0-9_-]+$` to the request property `containerTags/items/`
  - the `containerTags/items/` request property's maxLength was set to `100`

[Full history](https://skmtc.dev/supermemoryai/apis/supermemory-api/changes/v3/documents/bulk/delete.md)

---

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