API Reference
Restore previous version
Roll an automation back to its previous published version
On this page
This endpoint rolls an automation back to the version published immediately before the current one and re-publishes it — the undo for an update that made things worse. Only the previous version is supported. An automation that was turned off stays off after the restore.
Path Parameters
idstringrequired
The ID of the automation (from List automations)
This endpoint takes no request body.
Response
automation_idstring
The automation's ID
namestring
The automation's name after the restore
statusstring
enabled or disabled — the on/off state the automation had going into the restore is preserved
restored_version_idstring
The ID of the version that is now live
notestring
Confirmation that the previous version was restored and re-published
A missing automation — or one that does not belong to your account — returns a 404.
Error codes (422)
error |
Meaning |
|---|---|
no_previous_version |
There is no earlier version of this automation to roll back to. |
rollback_failed |
The previous version could not be restored — nothing changed. |
publish_failed |
The previous version was restored as the draft but could not be published, so it is not live yet — publish it in the app or retry. |
{
"automation_id": "f4EaLhOW2zoEsXXSOJP2r",
"name": "Order lookup",
"status": "enabled",
"restored_version_id": "8auMJQtqBnE1X8ZP7WVnI",
"note": "Rolled back to the previous published version and re-published it live."
}
{
"message": "There is no earlier version of this automation to roll back to.",
"error": "no_previous_version"
}
{
"message": "Automation not found, or it does not belong to your account.",
"error": "not_found"
}
Related guides
API Reference
Introduction
Welcome to the VoxLink API
Read guide →API Reference
Authentication
Learn how to authenticate your API requests
Read guide →API Reference
Get current user
Get the authenticated user's profile information
Read guide →API Reference
List assistants
List all assistants for the authenticated user with pagination
Read guide →