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

🟢200OK

application/json

Bulk operation results

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/admin/books/bulk' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "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 Example

{
    "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-09-08 18:04:49

Archive or permanently delete a book

Reorder books