Work with revisions

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.

Contents

• Simplify lifecycle management with revisions
  • Integration Lifecycle overview
  • Integration Lifecycle terminology
  •  Work with revisions
    • Revision types
    • Revision history
    • Filter revisions
    • View revision details in audit logs
• Manage lifecycle revisions

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.

If you have any conflicts, see Review and resolve conflicts.

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:

Filter revisions

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

1. On the Home page, click the integration.
2. On the integration page that opens, click the Revisions tab.
3. 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:

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