Product Updates

DatoCMS changelog for new features and general improvements
Content Management API
Breaking change in Workflows API
October 3rd, 2022

Starting October 10th, a couple of changes will be made to the CMA endpoints related to Workflows.

Workflows are a feature enabled in our Enterprise plans, so most of our users won't be affected by this change. All accounts actively using Workflows have already been notified via email about this change. If you did not receive an email, then you have nothing to worry about. 😉

Let's see how the workflow entity will change:

// Until October 10th:
{
"type": "workflow",
"id": "approval_by_editors",
"attributes": {
"name": "Approval by editors",
"stages": [...]
}
}
// From October 10th:
{
"type": "workflow",
"id": "123902133",
"attributes": {
"name": "Approval by editors",
"api_key": "approval_by_editors",
"stages": [...]
}
}

As you can see:

  • The old ID is now present in the new payload as attributes.api_key;

  • The ID becomes a regular DatoCMS ID, immutable during environment forks.

Please note that it will still be possible to fetch, update and delete workflows by passing the API key in the URL, although it is suggested to use the ID.

It will be required to pass the new ID instead of the API key every time a workflow is referenced in another entity relationship (ie. when creating/updating a Model) and inside roles permission rules.