---
title: "Delete Book"
method: POST
path: "/v1/book/remove"
tags: ["Book Commands"]
---

# Delete Book

`POST /v1/book/remove`

## Request

- Base URL: `https://api.ocrolus.com`
- URL: `https://api.ocrolus.com/v1/book/remove`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.ocrolus.com/oauth/token`

Delete a <<glossary:Book>> that you no longer need.

---
> 🚧 No turning back!
> Deleting a <<glossary:Book>> also deletes the <<glossary:Document>>s contained within. This action is not reversible, meaning that you can't recover deleted <<glossary:Document>>s and <<glossary:Book>>s. Make sure you're ready!

## Request body

- object
  - `book_id` string: The <<glossary:PK>> of the <<glossary:Book>> you'd like to delete. Mutually exclusive with `book_uuid`.
  - `book_uuid` string: The unique identifier of the <<glossary:Book>> you'd like to delete. Mutually exclusive with `book_id`.

## Response `200`

Success

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

## Other responses

- `400`: Client Errors

---

[API](https://skmtc.dev/ocrolus/apis/book-commands.md) - [All operations](https://skmtc.dev/ocrolus/apis/book-commands/llms.txt) - [OpenAPI document](https://skmtc.dev/ocrolus/apis/book-commands/revisions/2b1d4cab8032?raw)