Skip to main content
DELETE
/
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.delete({
  block_id: "c02fc1d3-db8b-45c5-a222-27595b15aea7"
})
{
  "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.

Sets a Block object, including page blocks, to in_trash: true using the ID specified. In the Notion UI application, this moves the block to the “Trash” where it can still be accessed and restored. To restore the block with the API, use the Update a block or Update page respectively.
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, or if the connection doesn’t have access to the block. Returns a 400 or 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

Response

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