---
title: "Delete documents (bulk)"
method: DELETE
path: "/public/v1/documents"
tags: ["Documents"]
---

# Delete documents (bulk)

`DELETE /public/v1/documents`

Delete multiple documents in one request by sending a JSON array. Each element must be an object with an `id` field (the document ID, same value as elsewhere in the Documents API).

The caller must have permission to delete each document. Documents must belong to the authenticated workspace.

This batch operation returns **200 OK** with a JSON body containing an `id` array of deleted document IDs. That differs from [Delete Document](#operation/deleteDocument) (`DELETE /public/v1/documents/{id}`), which returns **204 No Content** for a single document.

## Request body

- BulkDeleteDocumentsRequestItem[] — List of documents to delete. Each object must contain a document `id`.
  - `id` string, required — Document ID to delete.

## Response `200`

OK — documents were deleted. Response lists deleted document IDs.

- BulkDeleteDocumentsResponse
  - `id` string[], required — Document IDs that were deleted, in the same order as processed by the API.

## Other responses

- `400` — Bad Request
- `401` — Authentication error
- `403` — Permission error
- `404` — Not found
- `429` — Too Many Requests

---

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