Getting Started - How to Use Swagger Versions

The best way to ensure a new version of Swagger doesn't break your existing code is to define the specific version of Swagger you are using in your code. To do this, 

1. Call GET /elements/{id}/versions to get a list of all the element versions for system elements. We generate new versions based on every new server build, so you can essentially settle on a Swagger version that works for you and always call that. 

2. Specify the version you want to use in your Swagger API call with the following format: /elements/{elementId}/docs?version=xx, where xx is the version number you have settled on.