V2 Overview

V2 Availability

This documentation serves as an early preview in order to retrieve customer feedback.

Key Changes:

  • Authentication Standards have changed to OAuth. The use of Basic Authentication (username and password) and Client ID is no longer required.
  • Several new endpoints have been added.
  • All API Response payloads have changed to simplify the data returned and provide more complete datasets so that fewer subsequent API calls are needed for common use cases.
  • Responses no longer include denormalized objects for Metadata and Security.
  • The use of Epoch dates has been entirely removed and replaced with UTC date and time.
  • All API Responses implement paginated results when more than one result is expected.
  • Exponentially improved performance over v1 based on initial testing.
  • Updates to the HTTP Methods used, i.e., GET vs POST for certain endpoints.
  • Errors returned by Tenovos will always be an HTTP Status Code other than '200'.
  • Successful Asynchronous operations return a 202 with a task id that allows you to request status via the Task endpoints.
  • Successful Synchronous DELETE operations return a 204 status.
  • The Base URL is now standardized regardless of customer environment.
  • Tenovos API v2 uses the latest Open API Specification.