Basker Docs

Mutate document blocks

Apply ordered block operations (update, insertBefore, insertAfter, append, prepend, remove, moveBefore, moveAfter, replaceAll) to an Organization document. Requires draft: true and ifUpdatedAt in the request body. Rate limit: 20 requests per minute per API key.

PATCH
/{version}/{tenant}/organizations/{id}/blocks
Authorization<token>

Use format: users API-Key YOUR_API_KEY

In: header

Path Parameters

version*string

API version

Default"2026-02"
Value in"2026-02"
tenant*string

Tenant slug

id*string

Organization ID

Query Parameters

locale?string

Locale to mutate. Operates strictly on this locale with no fallback, so other locales are untouched.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://api.basker.app/partners/2026-02/string/organizations/string/blocks" \  -H "Content-Type: application/json" \  -d '{    "draft": true,    "ifUpdatedAt": "2019-08-24T14:15:22Z",    "operations": [      {}    ]  }'
{
  "versionTarget": "draft",
  "operations": [
    {}
  ],
  "document": {}
}
{
  "error": "string",
  "message": "string",
  "errors": [
    {}
  ],
  "requestId": "string"
}
{
  "error": "string",
  "message": "string",
  "errors": [
    {}
  ],
  "requestId": "string"
}
{
  "error": "string",
  "message": "string",
  "errors": [
    {}
  ],
  "requestId": "string"
}
{
  "error": "string",
  "message": "string",
  "errors": [
    {}
  ],
  "requestId": "string"
}
{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please retry later."
}