The Scheduled Actions API now provides the ability to update the timestamp or timezone of an existing scheduled action.

Previously scheduled actions could not be updated, meaning that developers needed to delete the existing scheduled action and then re-create it, leading to confusion and a change in scheduled action IDs. With the new API, developers can now modify the time that a scheduled action will execute without the ID of the scheduled action changing.

Updating a scheduled action follows similar behaviours to other Contentful APIs. To update a scheduled action, send the updated payload to the PUT endpoint for the scheduled action along with a X-Contentful-Version HTTP header specifying the current version of the scheduled action. The response will include the updated ScheduledAction entity, including the new sys.version for the action.

Note that the endpoint currently only allows updating the scheduledFor.datetime and the scheduledFor.timezone fields. Attempting to modify any other field will return an HTTP 400 Bad Request.

Learn more about the new endpoint, including how to use the CMA JS Library, in the CMA developer documentation