Blocks

Update a block

Changed on
patch/v1/blocks/{block_id}

Request

  • Base URL
    https://api.notion.com
  • URL
    https://api.notion.com/v1/blocks/{block_id}
  • Auth
    HTTP bearer

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": {
      "emoji": "😀"
    }
  }
}

Changes

  • 8967a2a7b255Revision changes
    • info

      added the optional property /////// to the response with the status

    • info

      added the required property ////// to the response with the status

  • c90a4587bc95Revision changes
    • warning

      added the new idempotency_key_reused enum value to the / response property for the response status