Help and Status API Endpoints Removed
  • 19 Dec 2024
  • Dark
    Light
  • PDF

Help and Status API Endpoints Removed

  • Dark
    Light
  • PDF

Article summary

Breaking Change Notices

IAP 2023.2 introduces a breaking change which affects the help API.

Help API Removed Due to Scheduled Deprecation

All dynamic and non-dynamic API endpoints within the Itential platform are now fully compliant with OpenAPI 3.0 specifications. This impacts all API documentation that is rendered through the help interface (Help UI) that displays when users click the Help link within IAP.

The help/api/json that supports the API documentation in-app (i.e., within the Itential application) is removed from IAP in the 2023.2 release and replaced with help/openapi.

Item Description Deprecation Release Scheduled Removal Release Replacement
GET /help/api/json Displays the Help UI within the system. 2023.1 2023.2 GET /help/openapi

What should I do?

Please update all API keys and HTTP/HTTPS clients to use the new help/openapi specification.

Status API Removed Due to Scheduled Deprecation

The GET /status API is removed from IAP in the 2023.2 release and replaced with the /health/status API that reports the health of all apps and adapters.

Item Description Deprecation Release Actual Removal Release Replacement
GET /status Reports on the status of the system at startup. 2023.1 2023.2 GET /health/status

What should I do?

Review any custom apps and adapters that might reference the /status API and change them to the new /health/status replacement call.


Was this article helpful?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.