Actions15
Overview
This node integrates with the DatoCMS API to manage content records within a specified item type. The Unpublish Record operation specifically allows users to unpublish a record by its ID, effectively removing it from the published state on the DatoCMS platform.
Typical use cases include:
- Automating content workflows where certain records need to be unpublished based on external triggers or conditions.
- Managing content lifecycle programmatically without manual intervention in the DatoCMS dashboard.
- Integrating with other systems to synchronize content states (e.g., unpublishing outdated or incorrect data).
Example: Automatically unpublish a blog post record when it is marked as outdated in another system.
Properties
| Name | Meaning |
|---|---|
| Item Type | The specific item type (content model) in DatoCMS to work with. Options can be selected from a searchable list or provided by ID. |
| Record ID | The unique identifier of the record to unpublish. |
Output
The output JSON contains the result of the unpublish operation for the specified record. It typically includes the record's data after being unpublished, reflecting its new unpublished state.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token credential for DatoCMS.
- The node uses the official DatoCMS Node.js client library to interact with the API.
- Proper permissions are needed on the API token to perform unpublish operations on records.
Troubleshooting
Error: "Failed to unpublish record" or similar API errors
Ensure that the provided Record ID exists and belongs to the specified Item Type. Also, verify that the API token has sufficient permissions to unpublish records.Error: "Record ID is required"
This occurs if the Record ID property is empty. Provide a valid record identifier.Error related to Item Type selection
If the item type is not correctly selected or invalid, the operation will fail. Use the resource locator to select a valid item type from the list or provide a correct ID.Network or Authentication Errors
Check the API token validity and network connectivity to DatoCMS.