roam_update_multiple_blocks

Update multiple blocks in a single batch operation to avoid multiple API calls. Replace or transform block content independently using patterns, streamlining edits in Roam Research.

Instructions

Efficiently update multiple blocks in a single batch operation. Use this when you need to update several blocks at once to avoid making multiple separate API calls. Each block in the batch can independently either have its content replaced or transformed using a pattern. NOTE on Roam-flavored markdown: For direct linking: use [[link]] syntax. For aliased linking, use alias syntax. Do not concatenate words in links/hashtags - correct: #[[multiple words]] #self-esteem (for typically hyphenated words).

Input Schema

Name	Required	Description	Default
`updates`	Yes	Array of block updates to perform

Input Schema (JSON Schema)

{
  "properties": {
    "updates": {
      "description": "Array of block updates to perform",
      "items": {
        "oneOf": [
          {
            "required": [
              "content"
            ]
          },
          {
            "required": [
              "transform"
            ]
          }
        ],
        "properties": {
          "block_uid": {
            "description": "UID of the block to update",
            "type": "string"
          },
          "content": {
            "description": "New content for the block. If not provided, transform will be used.",
            "type": "string"
          },
          "transform": {
            "description": "Pattern to transform the current content. Used if content is not provided.",
            "properties": {
              "find": {
                "description": "Text or regex pattern to find",
                "type": "string"
              },
              "global": {
                "default": true,
                "description": "Whether to replace all occurrences",
                "type": "boolean"
              },
              "replace": {
                "description": "Text to replace with",
                "type": "string"
              }
            },
            "required": [
              "find",
              "replace"
            ],
            "type": "object"
          }
        },
        "required": [
          "block_uid"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "updates"
  ],
  "type": "object"
}

Roam Research