Revert or undo Actions
Action reverts in Ontology Manager allow an Action to be reverted (that is, undone) immediately after the Action has been applied. You can revert an Action by selecting Undo in the success message after any successful Action application.
New Actions are revertible by default.
Action reverts are only available for Object Storage V2; meaning that only Actions that modify or create an object type in OSv2 can be reverted. If your object types are not currently stored in Object Storage V2, you can migrate by following this guide.
Configure a revertible Action
Currently, Actions can only be reverted by the user who applied the Action.
In the Form tab of an Action, toggle on the Allow revert after Action submission button. Once this toggle is correctly configured and saved to the Ontology, your Action can be reverted.
The Allow revert after Action submission toggle in the Form tab will be enabled by default for Actions created after May 2024 that only modify OSv2 object types. If an Action existed before May 2024 and modifies an object type in OSv2, Action reverts will not be toggled on by default but can be manually enabled.
You will not be able to revert an Action if it only modifies OSv1 object types.
Revert an Action
The toast below is your only opportunity to revert the Action. This is especially important to note when performing delete Actions.
Once reverted successfully, users will see a similar toast to the original Action success as shown below.
Edits applied:
Edits reverted:
Caveats
An Action revert may fail in some cases:
- An Action on an object cannot be reverted once any subsequent edit has been made to the object, even if the edit is on a different property. In other words, an Action on an object can only be reverted if the Action is the most recent edit to an object.
- An Action cannot be reverted if Action reverts has been toggled off after Action submission, even if Action reverts have been toggled on again.
An Action revert only reverts the edits to the object instance, but it will not revert side effects, such as notifications or webhooks, nor will it call them in the same way that the applied Action would have.
Undoing a delete action without the revert action toast
If a delete action is performed and you wish to undo the deletion, but the revert action toast is no longer available, the only remediation options available are to:
- Migrate to a new object type and copy over the desired edits using functions; or
- Drop all edits on the object type.