---
title: "Delete document"
method: POST
path: "/documents/document-delete"
tags: ["Document AI — DMS"]
---

# Delete document

`POST /documents/document-delete`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/documents/document-delete`
- Auth: HTTP bearer

po_documents_delete: Delete one or more documents. mode=trash (default): soft-delete to recycle bin on business/compliance workspaces; on standard-tier workspaces the API coerces trash to instant (permanent, no recycle bin)...

## Response `200`

Success

- object: Delete document(s) — soft-delete to trash or permanent deletion
  - `status` 'success' | 'error', required: Operation result status
  - `message` string: Human-readable status message
  - `deleted_count` integer: Number of deleted documents
  - `not_found_count` integer: Number of POFIDs not found
  - `error_count` integer: Number of failed deletions
  - `deleted_documents` object[]: List of deleted documents
    - `pofid` string: PaperOffice File ID
    - `file_name` string: File name
    - `documents_id` integer: Documents id
    - `workspace_id` integer: Workspace ID
  - `cleanup_queued` integer: Number of entries enqueued for deletion
  - `mode` 'trash' | 'instant': Delete mode: trash or instant (permanent)
  - `not_found_documents` string[]: POFIDs not found (optional)
  - `deleted_folders` string[]: Deleted document-folder IDs (optional)
  - `processing_time` string: Request processing time (e.g. "123.45ms")

## Other responses

- `4XX`: Error
- `5XX`: Error

---

[API](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api.md) · [All operations](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/revisions/c6a6228a4509?raw)