Work with revisions

Kathyana Queeman

Updated September 20, 2024 17:48

You can use the Revisions tab to monitor and manage changes your team makes to an integration over time (based on the access and permissions in an account or integration). Revisions use version control logic and git-style features to help you manage changes to your integration.

integrator.io creates a revision when you perform a pull, revert or snapshot operation in an integration. Every revision is associated with a unique identifier (ID). These features work similarly to git pull, revert, and diff or commit commands.

Important: You can manage and revert your integration to any revision you've ever created, regardless of its age. All revisions are saved in integrator.io.

Revision types

There are three basic revision types for integrations: pull, snapshot, and revert.

Important: You can only perform one revision at a time (a snapshot, a pull, or a revert).

Snapshot

You can spontaneously create a snapshot as a version control backup when you’re working on changes. This backup is especially useful when you are working on an integration in your production environment. integrator.io creates a "snapshot" revision when you click the Create snapshot button.

If you run into an error or other issue, you can revert (like git restore) to a snapshot revision and return to a stable state.

Pull

You can clone an integration, make changes, and then create a pull after successfully building and testing changes. There are four statuses for a pull: In progress, failed, canceled, or completed.

integrator.io automatically saves the integration state before any change is made and after all changes are merged, and your pull is completed. You can revert to either of these integration states within a completed pull revision.

integrator.io automatically creates a snapshot of the integration before any changes are made and after changes are merged, and your pull is completed. You can use these snapshots to roll back to a previous integration.

Revert

You can roll back to the previous state of a pull, snapshot, or revert when you run into issues and want to undo changes. This is called a “revert” revision. There are four statuses for a revert: In progress, failed, canceled, or completed.

integrator.io automatically saves the integration state before and after any change is undone or reversed and when your revert is completed. You can always roll back to either of these integration states within a completed revert revision.

Revision history

The Revisions list displays the history of every revision made in an integration because of a snapshot, pull, or revert. You can view details and perform actions on a revision based on the options available when you click the Actions overflow (...) menu of a revision.

The revision list or revision history provides the following information:

Column	What it shows…
Description	The description you provide for a revision when you create a snapshot, pull, or revert like the reason or summary of changes in a revision.
Date created	Time at which you create a snapshot, pull, or revert. The time is shown based on your date settings in the following format: DD-MM-YYYY hh:mm:ss
Type	Type of revision: Pull Revert Snapshot
Status	Revision status: In Progress Completed Failed Canceled Failed: The operation will fail when you try to revert to a revision that contains deprecated features or functions that integrator.io no longer supports. This is the most common case when you will likely receive the “Failed” status. A revision might fail in an extremely rare case due to a network issue. Canceled: You can cancel an In-progress pull or revert revision during the Merge step.
User	Name of the user who performs the revision.
Actions	Actions you can perform on a revision: In the case of a pull or revert: View details View resources changed Revert to before this revision Revert to after this revision In the case of a snapshot: View details Revert to this revision

Filter revisions

You can filter revisions based on user, date created, status, and type. To filter revisions:

On the Home page, click the integration.
On the integration page that opens, click the Revisions tab.
Select a value in the filter fields, such as date created, type, status, or user. You can select a value in any field or all the fields to filter the integrations.

View revision details in audit logs

You can view the changes made at the resource level for a pull or revert in the audit logs. You can also filter the audit logs to view changes based on resource, user, and source. To view the audit logs:

On the Home page, click the integration to open it.
On the integration page, click the Audit logs tab. You can view the changes or revision details at the resource level.