API User's Guide

API versions

Updates to the API are designed so that every new version remains compatible with earlier versions. As parts of the API are upgraded, the older replaced parts are deprecated but are not removed, so that existing applications can still use them.

The functionality that Alloy Navigator API delivers is specified by the "API Version" identifier. The default version is the latest one.

To access a specific version of the API, specify its identifier in the API URL. For example:

http://www.example.com/api/v1/object/T000002

IMPORTANT: If you do not specify the API version number in an URL, the system assumes the default v2 version.

The table below provides a brief overview of API versions.

API Version Alloy Navigator Version Description

v2

8 or later

This version supports HTML text in the Description field.

v1

7

In this version, the Description field for Change Requests, Incidents, Problems, Service Requests, and Work Orders is a Memo (plain text) field.

Chose this version, if you want to treat the Description as a plain text field.