Bulk upsert books

POST

/api/admin/books/bulk

Creates or updates multiple books in a single request.
Matches on slug for updates. Supports nested translations and cloud file links.

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: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Bulk operation results

Body

🟠400

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/admin/books/bulk' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "books": [
        {
            "titleEn": "Steps to Christ",
            "translations": [
                {
                    "languageCode": "fr",
                    "title": "Vers Jésus"
                }
            ],
            "files": [
                {
                    "languageCode": "fr",
                    "fileType": "pdf",
                    "sourceType": "google_drive",
                    "cloudUrl": "https://drive.google.com/file/d/abc123/view",
                    "fileName": "vers-jesus.pdf",
                    "fileSizeBytes": 3145728
                }
            ]
        }
    ]
}'

Response Example

200 - Success

{
    "summary": {
        "total": 1,
        "created": 0,
        "updated": 1,
        "failed": 0
    },
    "results": [
        {
            "index": 0,
            "slug": "steps-to-christ",
            "status": "updated",
            "bookId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
            "translationsUpserted": 1,
            "filesUpserted": 1
        }
    ]
}

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

Soft-delete a book

Reorder books