Actions15
Overview
This node integrates with the DatoCMS API to manage content records. Specifically, the Record - Delete operation allows users to delete a record of a specified item type by its unique record ID. This is useful in scenarios where you want to programmatically remove outdated or unwanted content from your DatoCMS project as part of an automated workflow.
Practical examples:
- Automatically deleting product entries that are discontinued.
- Removing blog posts or articles based on external triggers.
- Cleaning up test or temporary content after certain processes complete.
Properties
| Name | Meaning |
|---|---|
| Item Type | The type of content item (model) to work with. You can select from a list or specify an ID. |
| Record ID | The unique identifier of the record to delete. |
Output
The output JSON contains the response from the DatoCMS API after attempting to delete the record. Typically, this will be an object confirming the deletion or containing metadata about the deleted record. If the deletion fails, an error message will be returned instead.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token credential for DatoCMS with permissions to delete records.
- Uses the official DatoCMS Node.js client library (
@datocms/cma-client-node) internally. - No additional environment variables are required beyond the API credentials configured in n8n.
Troubleshooting
Common issues:
- Invalid or missing Record ID: Ensure the Record ID provided exists and is correct.
- Insufficient permissions: The API token must have rights to delete records in the specified item type.
- Network or API errors: Temporary connectivity issues or API rate limits may cause failures.
Error messages and resolutions:
"Failed to delete record: <message>"— Check if the record ID is valid and the API token has delete permissions."No value provided for matching field"or similar validation errors do not apply here since deletion requires only the record ID.- If multiple records are found (unlikely in delete by ID), ensure the correct unique ID is used.