Nimbu Developer Docs
ReferencePages

Apply a batch of page item operations

POST
/pages/{page_id}/batch

Executes a batch of operations against a page's editable items. Requires the current ETag in the If-Match header.

Authorization

AuthorizationBearer <token>

Personal access token tied to a user account. Requires the X-Nimbu-Site header to scope requests.

In: header

X-Nimbu-Site<token>

Identifier of the site context when authenticating with a personal access token.

In: header

Path Parameters

page_id*string

Page identifier or fullpath

Query Parameters

atomic?boolean

When true, all operations succeed or none are applied.

Header Parameters

If-Match*string

Strong ETag of the page being mutated. Required for optimistic concurrency control.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/pages/string/batch" \  -H "If-Match: string" \  -H "Content-Type: application/json" \  -d '{    "operations": [      {}    ]  }'
{
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}