Tools → Public API

Incorta’s public application programming interface (API) allows developers to interact with data within Incorta for programmatic uses. The power of being able to access data programmatically opens the door to many new uses of the application. Incorta receives API endpoint request payloads and returns response payloads in JSON. You must use the HTTPS scheme to be able to successfully run the Public API endpoints.

New version available

Starting the 2023.4.0 release, Public API v2 is available with seamless and enhanced authentication.

The previous version, Public API v1, will be available as well but it isn't compatible with the new authentication introduced in 2023.4.0. Thus, you can't use the 2023.4.0 release to generate new API keys or renew existing ones that are used in Public API v1. However, you can refresh existing access tokens, or you can use the latest API key that you generated before upgrading to 2023.4.0 or later releases and use it to create new access tokens for Public API v1 as usual.

To access Incorta public API (v1 or v2), the Super User or a user with the SuperRole has to enable public API access for your account. In addition, you must generate an API key or token for your corresponding user account within Incorta. The steps to generate an API key or token vary according to the API version. For details, refer to Public API v1 or Public API v2 depending on your Incorta Cloud release.