Add a file (local upload or cloud link)

POST

/api/admin/books/{bookId}/files

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 multipart/form-dataRequired

Responses

🟢201Created

application/json

File added

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/admin/books//files' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""' \
--form 'languageId=""' \
--form 'languageCode=""' \
--form 'fileType=""' \
--form 'autoExtractCover="true"' \
--form 'overrideCover="false"'

Response Example

201 - PDF uploaded (no cover extraction)

{
    "id": "f2b3c4d5-e6f7-8901-bcde-f12345678901",
    "fileName": "005-fr-loyaute-et-deloyaute.pdf",
    "coverExtracted": false,
    "coverFileName": null
}

Modified at 2026-09-08 18:04:49

List files for a book

Upload or replace a file