> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r28.ai/charter/llms.txt
> Use this file to discover all available pages before exploring further.

# blocks_delete

> Move a block to the trash. This is a soft delete: the block comes back with `in_trash` true and `blocks_update` can restore it.

<div className="tool-route"><span className="tool-row-method" data-method="DELETE">DELETE</span><code>{"https://api.notion.com/v1/blocks/{blockId}"}</code></div>

```python notion_blocks_delete.py theme={null}
from charter.packs import notion

result = await notion.blocks_delete.ainvoke({"blockId": ...})
```

<Note>
  Requires `Update content`.
</Note>

## Path parameters

<div className="reference-table">
  | Field                                                           | Type     | Description          |
  | --------------------------------------------------------------- | -------- | -------------------- |
  | `blockId` <span className="required" title="required">\*</span> | `string` | The ID of the block. |
</div>