Actions16
Overview
This node provides advanced integration with Notion, allowing users to manage Notion blocks programmatically. Specifically, the Delete Block operation enables users to delete a block in Notion by specifying its unique Block ID. This is useful for automating content management workflows where obsolete or unwanted blocks need to be removed from Notion pages or databases.
Practical examples include:
- Automatically cleaning up outdated sections in a project documentation page.
- Removing temporary notes or placeholders after processing data.
- Managing content lifecycle by deleting blocks based on external triggers or schedules.
Properties
| Name | Meaning |
|---|---|
| Block ID | The unique identifier of the Notion block to delete. |
| Additional Fields | Optional fields that can be set when working with blocks (not used in Delete operation). |
Note: For the Delete operation, only the Block ID property is required and used.
Output
The output of the Delete Block operation is the JSON response returned by the Notion API upon successful deletion of the block. Typically, this will be an empty object or confirmation of deletion without additional data.
No binary data is produced by this operation.
Dependencies
- Requires a valid Notion API authentication token configured in n8n credentials.
- Uses the Notion REST 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 checks credentials before execution. Ensure your API key/token is valid and has permissions to delete blocks.
- Block ID not found or invalid: If the specified Block ID does not exist or is malformed, the Notion API will return an error. Verify the Block ID is correct.
- Insufficient permissions: The API token must have access rights to modify the target block. Lack of permission will cause errors.
- Network or API errors: Temporary network issues or Notion API downtime may cause failures. Retry or check Notion status if persistent.
Common error messages:
"Invalid Notion API credentials": Check and update your API authentication."Unknown block operation: delete": This would indicate a misconfiguration; ensure the operation is correctly set to "Delete".- Errors related to block ID format or existence usually come directly from the Notion API response.