Skip to main content
PATCH
/
v1
/
blocks
/
{block_id}
TypeScript SDK
import { Client } from "@notionhq/client"

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

const response = await notion.blocks.update({
  block_id: "c02fc1d3-db8b-45c5-a222-27595b15aea7",
  paragraph: {
    rich_text: [{ text: { content: "Updated paragraph text" } }]
  }
})
{
  "object": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Documentation Index

Fetch the complete documentation index at: https://developers.notion.com/llms.txt

Use this file to discover all available pages before exploring further.

Updates the content for the specified block_id based on the block type. Supported fields based on the block object type (see Block object for available fields and the expected input for each field). Note: The update replaces the entire value for a given field. If a field is omitted (ex: omitting checked when updating a to_do block), the value will not be changed.
Updating child_page blocksTo update child_page type blocks, use the Update page endpoint. Updating the page’s title updates the text displayed in the associated child_page block.
Updating child_database blocksTo update child_database type blocks, use the Update database endpoint. Updating the page’s title updates the text displayed in the associated child_database block.
Updating childrenA block’s children CANNOT be directly updated with this endpoint. Instead use Append block children to add children.

​
Success

Returns a 200 HTTP response containing the updated block object on success.
Connection capabilitiesThis endpoint requires a connection to have update content capabilities. Attempting to call this API without update content capabilities will return an HTTP response with a 403 status code. For more information on connection capabilities, see the capabilities guide.

​
Errors

Returns a 404 HTTP response if the block doesn’t exist, is in the trash, or if the connection doesn’t have access to the page. Returns a 400 if the type for the block is incorrect or the input is incorrect for a given field. Returns a 400 or a 429 HTTP response if the request exceeds the request limits. Note: Each Public API endpoint can return several possible error codes. See the Error codes section of the Status codes documentation for more information.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2026-03-11.

Available options:
2026-03-11

Path Parameters

​
block_id
string
required

Body

application/json
​
embed
object
required
​
type
string
Allowed value: "embed"
​
in_trash
boolean

Response

​
object
string
required
Allowed value: "block"
​
id
string<uuid>
required