Archive or permanently delete a book

DELETE

/api/admin/books/{bookId}

Requires edit_books. mode: archive (default) sets isActive = 0,
archivedAt and archivedByUserId, keeping files, translations and
download history. mode: permanent requires the book to already be
archived and removes it along with all related rows and storage files.
Legacy aliases soft → archive and hard → permanent are accepted.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

API Key

Add parameter in cookie

next-auth.session-token

Example:

next-auth.session-token: ********************

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Book archived or permanently deleted

Bodyapplication/json

🟠401Unauthorized

🟠404Record Not Found

🟠409

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE '/api/admin/books/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "mode": "archive"
}'

Response Example

200 - Success Example

{
    "success": true,
    "mode": "archive"
}

Modified at 2026-09-11 13:19:16

Update a book

Bulk upsert books