Nimbu Developer Docs
ReferencePages

Delete a page

DELETE
/pages/{page_id}

Delete a page and its subpages. With If-Match the delete only happens when the page still matches that ETag (checked inside the page write lock); a stale value returns 412 with top-level current_etag, and a lock timeout returns 409 concurrent_modification. Without If-Match the delete is unconditional.

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

Header Parameters

If-Match?string

Optional ETag precondition: the quoted ETag from GET /pages/{page_id}. Checked inside the page write lock; stale → 412 with current_etag. Omit for an unconditional write. Only a single strong ETag is supported; W/"..." and multi-value If-Match are treated as stale.

Response Body

application/json

application/json

curl -X DELETE "https://example.com/pages/string"
Empty
{
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
{
  "message": "string",
  "code": "string",
  "current_etag": "string"
}