Public API

IO exposes a set of capabilities to the user through its public, HTTP-based REST API ("API"). The API enables access to IO data without using the IO UI, which is often a requirement for users who might want to make IO data available in other applications.

The API is written to the OpenAPI 3.0 standard and, as such, is mostly self-documenting. Virtana provides an OpenAPI YAML file that can be downloaded from IO and used in other applications such as Postman.

All API endpoints function over secure HTTP (HTTPS). The user can choose a language/application/framework of their choosing to interact with the API. All modern languages support HTTP/HTTPS requests through a variety of class libraries and frameworks. Examples are provided using the cURL command. As an alternative to viewing IO data via its web-based UI, the API provides stateless access to the following categories of IO data: inventory (entity) and metrics data.

The API maintains backward compatibility across IO minor and patch versions. Its development aligns with IO integrations and it is updated on a bi-monthly release schedule.