Tenovos API v2 is currently in design and is not ready for Production use. This documentation serves as an early preview in order to retrieve customer feedback.

Note that the v2 API supports OAUTH Authentication. Calling an authorization endpoint is no longer required.

LAST UPDATED: January 23, 2024

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. All requests for Production go to https://api.tenovos.io/v2
• Tenovos API v2 uses the latest Open API Specification 3.1.x.

To provide feedback on v2 of the API, please submit an Idea to the Product Team from the Ideas Portal using the API Category.

API version 1.x is expected to be supported until July, 2025. Customers may leverage both v1 and v2 at the same time while transitioning to v2.

Check back each week as we publish additional endpoints!