---
title: "Delete document"
method: POST
path: "/v1/document/remove"
tags: ["File Commands"]
---

# Delete document

`POST /v1/document/remove`

Delete a <<glossary:Document>> uploaded to a <<glossary:Book>>.

---
You can only delete files that are in the `VERIFICATION_COMPLETE` or `REJECTED` states. Attempting to delete a file in any other state will return a failure as shown in the examples.
> 🚧 No turning back!
> Deleted <<glossary:Document>>s and associated data (such as transactions) cannot be recovered. Make sure you're ready!

## Request body

- object
  - `doc_uuid` string — The unique identifier of the <<glossary:Document>> (*not* the <<glossary:Book>>) that will be deleted. Mutually exclusive with `doc_id`.
  - `doc_id` string — The <<glossary:PK>> of the <<glossary:Document>> (*not* the <<glossary:Book>>) that will be deleted. Mutually exclusive with `doc_uuid`.

## Response `200`

Success

- object
  - `status` integer — A numerical code that indicates the status of the request.
  - `response` object — An object received from the server that potentially contains data.
  - `message` string — A textual description that indicates details about this response's status.

## Other responses

- `400` — Client Errors

---

[API](https://skmtc.net/ocrolus/apis/user-management.md) · [All operations](https://skmtc.net/ocrolus/apis/user-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ocrolus/user-management/revisions/3571ef602d13/schema)