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

🟢200

application/json

File replaced (existing was soft-deleted)

Body

🟢201

🟠400

🟠404

🟠401Unauthorized

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=""'

Response Example

200 - Success

{
    "id": "f3c4d5e6-f7a8-9012-cdef-123456789012",
    "fileName": "gc-en-v2.pdf",
    "fileSizeBytes": 5600000,
    "fileType": "pdf",
    "sourceType": "local",
    "filePath": "storage/books/files/the-great-controversy/en/gc-en-v2.pdf",
    "replaced": true
}

Modified at 2026-03-27 22:49:45

Add a file (local upload or cloud link)

Update file metadata