Welcome to our Updates page, where you can find news and information about our latest API releases.
Version: 2023-07-25
This release introduces enhancements to the List Tasks in a Runbook response, to the runbook resource and to the Get a Runbook endpoint.
We’ve made two enhancements to the List Tasks in a Runbook response:
Note: You need to at least have Cutover Core version 3.81 to benefit from both of these improvements.
We’ve made two enhancements to the the Runbook resource:
Note: You need to at least have Cutover Core version 3.81 to benefit from both of these improvements.
In light of the addition of the external_id attribute to the Runbook resource, a new query parameter has been added to the Get a Runbook endpoint:
It can filter on either a normal runbook id or on the external_id.
Note: You need to at least have Cutover Core version 3.81 to use this query parameter.
Version: 2023-05-22
This release introduces two new query parameters for listing action logs, plus a couple of other minor improvements and fixes.
We've added two new query parameters to the List Action Logs endpoint:
These new query parameters allow you to filter by actions performed after and before a given date and time.
Note: You need to at least have Cutover Core version 3.79 to use these query parameters.
Version: 2023-05-04
This release introduces three new endpoints for runbook teams, plus some other enhancements for template workflows.
We've added three new RunbookTeam endpoints:
These endpoints give you greater control and more efficient management over your runbook teams. You can create new runbook teams in a specified runbook, as well as delete them from a specified runbook. You can also unlink a runbook team from its centralized team, which copies its list of users over to a specified runbook which can then be customized.
We’ve added the following attributes to the Runbook resource to help with managing and tracking template workflows. They can be used to retrieve the status of templates, as well as provide other key information, all of which can be important for reporting purposes.
Version: 2023-03-01
This release introduces two enhancements to the task resource.
We’ve added the following in relation to the auto_finish attribute. Note: You need to at least have Cutover Core version 3.76 to benefit from these improvements:
Version: 2023-01-31
This release introduces three enhancements to the task resource, the List Folders endpoint and the stream resource respectively.
We’ve added an auto_finish attribute to the Task resource. This means you can read whether a task is set to automatically finish, as well as use the endpoints Create a New Task and Update a Task to apply automatic finishes to tasks. To clarify the working of the auto finish feature, a task will automatically finish once its specified duration has expired, provided all validation has passed beforehand. Note: You need to at least have Cutover Core version 3.76 to benefit from this improvement.
We’ve added meta.permissions data to the Folder resource in the List Folders response, enabling you to read which folders you have the permission to create runbooks in. Note: You need to at least have Cutover Core version 3.76 to benefit from this improvement.
We’ve added parent data to the stream.relationships object so you can see which substreams belong to which parent stream.
Version: 2023-01-11
This release introduces an enhancement to the folder resource.
We’ve added parent data to the folder.relationships object so you can see which subfolders belong to which parent folder, create new subfolders, and update subfolders so they belong to different parent folders. Note: You need to at least have Cutover Core version 3.73 to benefit from this improvement.
Version: 2022-12-06
This release introduces a new endpoint for runbook teams, plus an enhancement to task endpoints.
Firstly, a notice: A fix has been implemented in Cutover Core version 3.73 meaning that Update a Runbook works as expected. If you have an earlier Cutover Core version, the call incorrectly results in creating a new or empty runbook version. To avoid this, upgrade to 3.73.
We've added a new RunbookTeam endpoint:
This endpoint lets you retrieve all runbook teams from the current version of a specified runbook.
Note: You need to at least have Cutover Core version 3.73 to use this endpoint.
For Task endpoints, we've added the ability to read and update runbook teams who are assigned to, and are recipients of communications from, a task. Note: You need to at least have Cutover Core version 3.73 to benefit from this improvement.
Version: 2022-09-26
This release introduces two new endpoints for teams and runbooks respectively, as well as some other minor improvements and fixes.
We've added a new Team endpoint:
This endpoint lets you delete a centralized team that you no longer require. It will temporarily mark the team as archived before copying all deleted roles to linked runbook teams, and then fully deleting the team.
We've added a new Runbook endpoint:
This endpoint lets you retrieve the roles (for example Runbook Admin, Stream Editor and Runbook Member) connected to a specified runbook.
Note: You need to at least have Cutover Core version 3.65 for this endpoint to work.
Version: 2022-09-08
This release introduces a couple of enhancements to a task and user endpoint respectively, as well as some other minor improvements and fixes.
When you request a source_runbook in the List Tasks in a Runbook endpoint via the source_runbook_id query parameter, the response now includes the full runbook object in the included array. Note: You need at least Cutover Core version 3.67 to benefit from this enhancement.
We’ve enhanced the included object in the Get roles for a user endpoint’s response to include all possible resources that the relationships object references within it.
Version: 2022-08-24
This release introduces a new endpoint for retrieving information on team roles, as well as some other minor improvements and fixes.
We've added a new Team endpoint:
This endpoint lets you retrieve the roles for a team member by their ID or email.
Note: You need to at least have Cutover Core version 3.65 for this endpoint to work.
Version: 2022-08-02
This release introduces a new endpoint for merging runbooks, as well as several other minor improvements and fixes.
We have added a new Runbook endpoint:
This endpoint lets you merge single or multiple runbooks into the runbook that you specify in the path parameter.
Note: You need to at least have Cutover Core version 3.65 for this endpoint to work.
Version: 2022-07-13
This release adds support for Cutover Core version 3.64, adding communication- and login-related attributes to the user resource.
We have added some new attributes to the User resource to increase its comprehensiveness.
Version: 2022-06-22
This release adds support for Cutover Core version 3.63, introducing two new endpoints for folders.
We have added two new Folder endpoints:
These endpoints give you greater control and management over your folders in a specified workspace. You can create new folders and you can update the name and description of existing ones.
Version: 2022-06-03
This release adds support for Cutover Core versions 3.61 and 3.62, introducing nine new endpoints covering action logs, custom fields, runbooks and tasks.
We have added a new ActionLog endpoint:
Provided you are either a Global User Admin or a Global Stakeholder, this lets you retrieve all of the action logs for your instance. Action logs provide you with a description of the action, any related changes because of the action, the author of the action, and the resource involved in the action. This information can be used for auditing purposes.
We have added five new Custom Field endpoints:
These endpoints give you the ability to manage your custom fields. List Custom Fields lets you retrieve all of the custom fields in your instance, whereas Get a Custom Field lets you retrieve a specific custom field by its ID. Delete a Custom Field will in fact archive (as opposed to hard deleting) a custom field you no longer wish to make use of, meaning it is still possible to read it at a later date.
We have added a new Runbook endpoint:
This endpoint lets you archive a runbook, removing its visibility and access from your instance once it is no longer required or has served its purpose.
We have added two new Task endpoints:
These endpoints add to the existing task endpoints, furthering your ability to control and manage tasks by being able to skip or delete a specific one in a runbook.
Version: 2022-05-16
This release adds support for Cutover Core version 3.60, introducing eight new endpoints covering role types, user app tokens, and workspaces.
We have added a new Role Type endpoint:
This lets you retrieve all of the role types that are currently enabled in your instance, providing an ID and a description of the role type. You can then use role type IDs when creating, updating or simply just reading roles.
We have added three new User App Token endpoints:
These endpoints provide you with the ability to control and manage API access to your Cutover instance. List User App Tokens lets you retrieve all of the user app tokens belonging to a specific user. Create a New User App Token lets you create new tokens per user, and Delete a User App Token lets you delete tokens per user (effectively meaning you can revoke a user’s API access).
We have added four new Workspace endpoints:
These endpoints provide you with the ability to manage your workspaces. Update a Workspace lets you update the name and description of a specified workspace, Archive a Workspace lets you remove visibility and access to a specified workspace once it is no longer required or has served its purpose, while Unarchive a Workspace lets you restore it if it is needed again.
We have added a 'Changelog' section to your instance’s API Portal, providing you with a list of all the changes for every API version that we release.
The section is accessed by clicking on My Profile in the bottom-left corner of the app and, under where it says 'View API endpoint documentation with credentials:' in the My Details panel, click either On the Developer Portal or On your API instance.
This takes you to the ‘Overview’ page, at the top of which sits the ‘Changelog’.