Actions15
Overview
This node integrates with the DatoCMS API to update existing records of a specified item type. It allows users to modify fields of a record by providing the record ID and the new field values. The node supports advanced field mapping, including handling JSON and localized fields, and can optionally auto-publish the updated record.
Common scenarios:
- Updating content entries in DatoCMS after receiving new data from other systems.
- Modifying specific fields of a CMS record without replacing the entire entry.
- Automating content workflows where updates trigger publishing automatically.
Practical example:
You have a product catalog managed in DatoCMS. When product details change in your ERP system, you use this node to update the corresponding product record in DatoCMS by specifying the record ID and the fields to update (e.g., price, description). You can enable auto-publish so changes go live immediately.
Properties
| Name | Meaning |
|---|---|
| Item Type | The type of item (content model) to work with. Selectable from a list or specified by ID. |
| Record ID | The unique identifier of the record to update. |
| Fields | The fields to update in the record. Supports defining fields manually or auto-mapping input data. |
| Additional Fields | Extra options for the update operation. Currently supports: • Auto Publish: Automatically publish the record after update (boolean). |
Output
The node outputs the updated record as a JSON object under the json property. This includes all fields returned by the DatoCMS API for the updated record.
If "Auto Publish" is enabled, the output reflects the published state of the record.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token credential for DatoCMS with appropriate permissions.
- Uses the official DatoCMS Node.js client library internally.
- No additional environment variables are required beyond the configured API credentials.
Troubleshooting
Error: "Please select an Item Type first"
Occurs if the item type parameter is missing or empty. Ensure you select or specify a valid item type before running the node.Error: "No value provided for matching field ..."
Happens if required fields for matching or updating are not provided. Verify that the fields parameter contains valid data.Error: "Failed to load model fields" or "Failed to load item types"
Indicates issues fetching metadata from DatoCMS, possibly due to invalid credentials or insufficient permissions. Check API token validity and access rights.JSON parsing errors on fields
Some fields require JSON-formatted strings. If you provide malformed JSON, the node may throw errors. Make sure JSON strings are well-formed or use the UI to define fields properly.Auto Publish does not reflect immediately
Publishing might take some time depending on DatoCMS backend. Confirm the record status via the DatoCMS dashboard if unsure.