Upload or replace a file

PUT

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

Replaces the existing file for the given book + language + fileType combination.
Soft-deletes the old record and removes the old file from disk.

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

🟢200OK

application/json

File replaced (existing was soft-deleted)

Bodyapplication/json

🟢201Created

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Success Example

{
    "id": "f3c4d5e6-f7a8-9012-cdef-123456789012",
    "fileName": "003-en-spiritual-man.pdf",
    "fileSizeBytes": 5600000,
    "fileType": "pdf",
    "sourceType": "local",
    "filePath": "storage/books/spiritual-man/files/en/003-en-spiritual-man.pdf",
    "replaced": true,
    "coverExtracted": false,
    "coverFileName": null
}

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

Add a file (local upload or cloud link)

Update file metadata