Update a Block

client.blocks.update(args: UpdateBlockParameters): Promise<UpdateBlockResponse>

import { Client } from "@notionhq/client"

const notion = new Client({ auth: process.env.NOTION_TOKEN })

const updatedBlock = await notion.blocks.update({
  block_id: "paragraph-block-id",
  paragraph: {
    rich_text: [
      {
        type: "text",
        text: {
          content: "Updated paragraph content",
        },
      },
    ],
    color: "blue",
  },
})

console.log("Block updated:", updatedBlock.last_edited_time)

const codeBlock = await notion.blocks.update({
  block_id: "code-block-id",
  code: {
    rich_text: [
      {
        type: "text",
        text: {
          content: "console.log('Hello, World!')",
        },
      },
    ],
    language: "javascript",
    caption: [
      {
        type: "text",
        text: {
          content: "Example code",
        },
      },
    ],
  },
})

const todoBlock = await notion.blocks.update({
  block_id: "todo-block-id",
  to_do: {
    rich_text: [
      {
        type: "text",
        text: {
          content: "Complete documentation",
        },
      },
    ],
    checked: true,
  },
})

console.log("To-do checked:", todoBlock.type === "to_do" && todoBlock.to_do.checked)

// Archive a block without changing its content
const archivedBlock = await notion.blocks.update({
  block_id: "your-block-id",
  archived: true,
})

console.log("Block archived:", archivedBlock.archived)

// Move a block out of trash
const restoredBlock = await notion.blocks.update({
  block_id: "your-block-id",
  in_trash: false,
})

console.log("Block restored:", !restoredBlock.in_trash)

const calloutBlock = await notion.blocks.update({
  block_id: "callout-block-id",
  callout: {
    rich_text: [
      {
        type: "text",
        text: {
          content: "Important note!",
        },
      },
    ],
    icon: {
      type: "emoji",
      emoji: "💡",
    },
    color: "yellow_background",
  },
})

import { APIResponseError } from "@notionhq/client"

try {
  const block = await notion.blocks.update({
    block_id: "your-block-id",
    paragraph: {
      rich_text: [{ type: "text", text: { content: "New content" } }],
    },
  })
} catch (error) {
  if (APIResponseError.isAPIResponseError(error)) {
    switch (error.code) {
      case "object_not_found":
        console.error("Block not found")
        break
      case "validation_error":
        console.error("Invalid update parameters:", error.message)
        break
      case "unauthorized":
        console.error("Not authorized to update this block")
        break
      default:
        console.error("API error:", error.code, error.message)
    }
  }
}

// TypeScript enforces correct structure for each block type
const block = await notion.blocks.update({
  block_id: "id",
  heading_1: {
    rich_text: [{ type: "text", text: { content: "Title" } }],
    color: "blue", // Autocomplete for valid colors
    is_toggleable: true,
  },
})

// Type guard for type-specific properties
if (block.type === "heading_1") {
  console.log(block.heading_1.is_toggleable)
}