Actions16
Overview
This node operation deletes a specific block in Notion by its Block ID. It is useful when you want to programmatically remove content blocks from a Notion page or database, such as paragraphs, headings, images, or other block types. For example, if you have an automated workflow that cleans up outdated or irrelevant sections in your Notion workspace, this operation can delete those blocks efficiently.
Properties
| Name | Meaning |
|---|---|
| Block ID | The unique identifier of the block to be deleted. This is required to specify which block to remove. |
| Additional Fields | A collection of optional fields (Icon, Cover, Archive) — not applicable for delete operation here. |
Output
The output JSON contains the response from the Notion API after deleting the block. Typically, a successful deletion returns an empty object or confirmation of deletion. No binary data is output by this operation.
Dependencies
- Requires a valid Notion API authentication token configured in n8n credentials.
- Uses the Notion API endpoint
DELETE /blocks/{block_id}to perform the deletion. - The node depends on utility functions for credential validation and API request handling.
Troubleshooting
- Invalid Notion API credentials: The node will throw an error if the provided API key or token is invalid or missing. Ensure the API key credential is correctly set up in n8n.
- Block ID not found or invalid: If the Block ID does not exist or is malformed, the Notion API will return an error. Verify the Block ID is correct.
- Permission issues: The API token must have sufficient permissions to delete blocks in the target workspace.
- Network or API errors: Temporary network issues or Notion API rate limits may cause failures. Retry or check API status if errors persist.