---
title: "Delete documents"
method: DELETE
path: "/inboxes/{inbox_id}/documents"
tags: ["inboxes"]
---

# Delete documents

`DELETE /inboxes/{inbox_id}/documents`

in the given inbox.

how parameter: if how == "FULL", we delete the entire document, including its source files
if how == "SOURCE_FILES", we only remove the (source) files and we set the archived flag. In practice this means
all information in the database (json) remains available, but you can no longer download / visualise the original document.

what parameter: if what == "DONE", we will only delete files which have status_data.feedback == True
if what == "ALL" we will delete all files

Start_date and end_date: when specified we will only delete files which are received after (respectively before) the timestamp

**WARNING** This will completely remove the documents, this is **not recoverable**

## Query parameters

- `how` 'FULL' | 'SOURCE_FILES'
- `what` 'ALL' | 'DONE'
- `start_date` string, date-time
- `end_date` string, date-time

## Response `204`

No Content

## Other responses

- `404` — Not Found

---

[API](https://skmtc.net/contractp/apis/contract-p.md) · [All operations](https://skmtc.net/contractp/apis/contract-p/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/contractp/contract-p/revisions/8ce53ebd6bd3/schema)