Docs‎ > ‎API Creator‎ > ‎Create your API Project‎ > ‎

API Versions

Versions are part of the URL of a REST endpoint. The version name is a unique string value that you can use to create different namespaces for different custom resources. API versions are part of the URL so that you can define new resources yet preserve the existing API under an older version.

The last (darkest) portion of the URL reflects the request you are coding. The first part is the name of the API version you are targeting. The second part is the request, which includes your resource name, followed by parameters, such as the primary key, filters, and ordering. Your resource name is either a base table or a defined resource. You can specify resource names with dot notation to access contained resources (for example, OneCustomer.Orders).

Note: Your code might create a prefix for the service/project portion to be prepended to the request.

Best Practice: To facilitate controlled migration over revisions, avoid hard-coding the API version into the URL.

The following image shows the Versions page, including the URL details:

Switch Between Versions

After you have created a new version, you can switch between versions (the REST Lab will also allow filtering by version names) using the Resource editor. The following image shows the