- 19 Dec 2024
-
DarkLight
-
PDF
Help and Status API Endpoints Removed
- Updated on 19 Dec 2024
-
DarkLight
-
PDF
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.