## Delete a document (tenant:dms:write)

`DELETE /api/dms/v1/documents/{id}`

Module: DMS · operationId: `deleteDocument` · Tag: Documents · Auth: access token (`Authorization: Bearer <accessToken>`)

Soft delete: the document disappears from the API, its record, hashes and audit trail stay
(GoBD) and the files are purged later. Refused with `409` while the document is under legal
hold, under an active WORM lock, or its retention period (`retentionUntil`) has not ended.
The optional body records a reason in the audit trail.

### Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string (uuid) | yes |  |

### Request body

`application/json`

- `reason` (string): Recorded in the audit trail

Example:

```json
{
  "reason": "Doppelt erfasst"
}
```

### Responses

- **204** Deleted
- **400** Error (`application/json`)
- **404** Error (`application/json`)
- **409** Error (`application/json`)

### Example request

```bash
curl -X DELETE 'https://api.mbcom.cloud/api/dms/v1/documents/3f2b8c1e-7d4a-4e9b-9c2a-5b1d6e8f0a12' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"reason":"Doppelt erfasst"}'
```
