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": "block",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
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.
Integration capabilitiesThis endpoint requires an integration 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 integration capabilities, see the capabilities guide.

​
Errors

Returns a 404 HTTP response if the block doesn’t exist, has been archived, or if the integration 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 2025-09-03.

Available options:
2025-09-03

Path Parameters

​
block_id
string
required

Body

application/json
​
embed
object
required
​
type
enum<string>
Available options:
embed
​
archived
boolean
​
in_trash
boolean

Response

​
object
enum<string>
required
Available options:
block
​
id
string<uuid>
required