v3

latestOpenAPI 3.1.02026-07-31495191.1 MB

Blocks

Update a block

patch/v1/blocks/{block_id}

Path parameters

block_idstring required

Headers

Notion-Version'2026-03-11' required

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

Request body

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

OR

Example request

{
  "embed": {
    "caption": [
      {
        "text": {
          "link": {
            "url": "https://www.notion.com"
          }
        }
      }
    ]
  }
}

Response

OR

Example response

{
  "paragraph": {
    "rich_text": [
      {
        "text": {
          "link": {
            "url": "https://www.notion.com"
          }
        }
      }
    ],
    "icon": {
      "icon": {
        "name": "pizza"
      }
    }
  }
}