docs
  1. SCAYLE Resource Center
  2. Add-on API
  3. Getting Started
  4. Versioning

Versioning

The Add-on API uses URI versioning.

For example, in https://{{tenant-space}}.panel.scayle.cloud/v1/ the current version is v1.

Whenever making a request to the Add-on API, you have to specify the version inside the URI.

Backwards-Compatible Changes

When backwards-compatible changes are made to the Add-on API no new version is released. Backwards-compatible changes include the following:

  • Adding new API resources.
  • Adding new optional request parameters.
  • Adding new properties to responses.

Backwards-Incompatible Changes

When backwards-incompatible changes are made to the Add-on API , a new version is released. Backwards-incompatible changes include the following:

  • Deleting existing API resources.
  • Adding new required parameters to existing API methods.
  • Removing properties from an existing API response.
  • Changing data types of existing properties.