A revert rolls back an integration to a previously saved revision — a snapshot, a completed pull, or an earlier revert. For the integrations and resources you can revert, see Supported integrations and resources. Use this procedure when you need to undo changes after a failed deployment, a broken flow, or any scenario where you want to restore a stable prior state. Each completed revert has its own before and after restore points, so you can undo a revert; see Revert to a pull or previous revert revision.
Note: All revisions are saved indefinitely in integrator.io, so you can revert to any revision you've created.
Prerequisites
Before you begin, confirm the following:
- Permission — You have Manage access to the integration, or you're an account owner or administrator. See Manage user roles & permissions to an account.
- Existing revision — The integration has at least one revision created by a snapshot, pull, or revert operation.
- Viewing only — To view revert details or resources changed, Monitor access is enough.
Revert to a snapshot
Reverting to a snapshot restores the integration's configuration to the state captured when the snapshot was created. Snapshots have a single restore point, so there's no before or after option.
- Select an environment at the top of the page.
- Go to Home, and then select the integration.
- Select Revisions.
-
Select Actions (...) on the snapshot revision row and select Revert to this revision.
The Create revert panel opens.
- Enter a Description for this revert revision. The read-only Revert to revision description, Revert to revision created date, and Revert to revision ID show the description, created date, and ID of the revision you're reverting to, so you can confirm you selected the right one. Next stays disabled until you enter a description.
-
Review the listed changes in Review changes, and then select Next. Reverting never creates conflicts.
The Revert changes panel opens and lists numbered steps.
- If the panel lists a connection step that needs setup, select Configure and configure the connection.
- On the final Revert changes step, select Revert.
The revert appears in the Revisions list with a Completed status when it finishes.
Revert to a pull or previous revert revision
Pull and revert revisions have two restore points: the integration state before the revision ran, and the state after it completed. Choose the point that matches what you want to restore.
- Select an environment at the top of the page.
- Go to Home, and then select the integration.
- Select Revisions.
-
Select Actions (...) on the pull or revert revision row and select one of the following:
- Revert to after this revision — Restores the integration to the state it was in after the pull or revert completed.
- Revert to before this revision — Restores the integration to the state it was in before the pull or revert ran.
The Create revert panel opens.
- Enter a Description for this revert revision. The read-only Revert to revision description, Revert to revision created date, and Revert to revision ID show the description, created date, and ID of the revision you're reverting to. Next stays disabled until you enter a description.
-
Review the listed changes in Review changes, and then select Next. Reverting never creates conflicts.
The Revert changes panel opens and lists numbered steps.
- If the panel lists a connection step that needs setup, select Configure and configure the connection.
- On the final Revert changes step, select Revert.
The revert appears in the Revisions list with a Completed status when it finishes.
For details on reading the diff, see Review changes panel reference.
Cancel or resume a revert
A revert stays In progress until you complete or cancel it. If you select Close in the Revert changes panel, the revert isn't canceled; it stays In progress so you can resume it later.
- To cancel a revert, select Cancel revert at the top right of the Revert changes panel. If you already closed the panel, select Actions (...) on the in-progress revert row in Revisions, and then select Cancel revision.
- To resume an in-progress revert, select Actions (...) on the in-progress revert row in Revisions, and then select Resume operation.
Canceled reverts remain in the revision history with a Canceled status.
After you revert
Some items aren't restored by a revert, or need attention the first time you use the reverted integration. For the full list, see Supported integrations and resources.
A revert restores topic configuration (name, description, and retention), but doesn't restore a topic's messages or change where a subscription resumes. See Topics.
A revert never restores lookup cache data, so repopulate it before you run any flows; see Lookup caches.
Note: When you create a revert for an integration that contains a real-time export with authentication, you enter its credentials the first time. After that, you don't need to enter them again unless they change. See Webhook credentials.
View revert details and resources changed
You can view the description and metadata for any revert revision, and inspect which resources were modified.
- Select an environment at the top of the page.
- Go to Home, and then select the integration.
- Select Revisions.
- Select Actions (...) on the revert revision row.
-
Select View details to see the revision metadata, or, on a completed revert, select View resources changed to see which resources were modified.
- Expand each section to review the changes.
Notes and constraints
- Only one revision operation can run at a time. See Revision types.
- A revert most commonly shows a Failed status because the target revision contains deprecated features; see Failed revision status.
- Only Completed revisions are available as revert targets. Failed and Canceled revisions can't be reverted to.