Skip to main content

Version Control

Vista implements version control, in the form of branches to let you safely and iteratively roll out changes to your permissions blueprint.


Branches represent the state of your blueprint, and are similar to git-style branches. Branches enable you to roll out changes to your permissions blueprint in an iterative way:

  • clone an existing branch
  • In the new branch, make necessary changes to the blueprint
  • Change the branch argument in the Vista Client Library (value is a string, so releasing permissions updates can be done at the customer level)
client = VistaClient('API_KEY', 'BRANCH_NAME')

Cloning Branches

Branches can be cloned via the Dashboard or API. When a branch is cloned, the old branch's blueprint is copied to the new branch. This include all Resource Types, Roles, as well as relationships between resource objects.