Documentation Nexus IQ Server 1.17

Our documentation site has moved. For the most current version, please see http://help.sonatype.com

3.3. REST API Versioning

The Nexus IQ Server REST APIs are versioned. As a best practice we recommend using the latest version of the Nexus IQ Server and in addition to the latest version of the REST APIs. This ensures your system will take advantage of the latest features and improvements.

However, we also realize that users of previous versions need to maintain this compatibility even when there is an update. For this reason, we do provide support for previous versions based on the criteria below.

Supported API Versions
  • Sonatype CLM 1.12 and earlier - Only Supports REST API v1
  • Sonatype CLM 1.13 and later - Supports Both REST API v1 and v2
  • Nexus IQ Server 1.17 and later - Recommend usage of v2 REST API only.

Identifying the version of the API is simple. Below we have provided an example using the REST API for retrieval of an organization ID.

http://localhost:8070/api/v2/organizations

As you can see, the v2 located just after api indicates the version of the API. If you find that the API version you are using is not documented, and would like information on upgrading to the latest version you can contact our support team for assistance.