Breaking changes
This page lists all breaking changes introduced in the 2023.2 release series. Review these changes before upgrading to ensure your workflows, integrations, and customizations remain functional.
| Version | Change | Description |
|---|---|---|
| 2023.2 | AngularJS not supported in manual tasks | Operations Manager no longer supports AngularJS in manual tasks. All AngularJS-based manual task endpoints have been removed. |
| 2023.2 | Audit Trail collection removed | The audit_trail MongoDB collection has been removed. No replacement is available. |
| 2023.2 | Broken references | Applications or adapters with missing $ref JSON Schema targets now fail to start rather than silently accepting any data type. |
| 2023.2 | Data Path property renamed | The dataPath property in API validation error objects has been renamed to instancePath and reformatted as a JSON Pointer. |
| 2023.2 | Default adapter protocol | The default protocol for Adapters has changed from HTTP to HTTPS |
| 2023.2 | DryRun and View DryRun manual tasks removed | The dryRun and viewDryRun manual tasks have been removed. Use testInstances and ViewData instead. |
| 2023.2 | Help and Status API endpoints removed | GET /help/api/json replaced by GET /help/openapi. GET /status replaced by GET /health/status. |
| 2023.2 | Integration API routes removed | All automatically generated integration API routes have been removed. Use integration tasks inside workflows instead. |
| 2023.2 | Itential Platform key removed from global config | The iap key has been removed from the global config object available to custom apps and adapters. |
| 2023.2 | Itential Tools updated | itential_tools has been updated for Cisco NSO 6.4 compatibility and is not backward compatible with earlier NSO versions. |
| 2023.2 | IWAN tasks removed | The IWANChooseQOS, IWANChooseHub, and IWANChooseSite tasks have been removed from app-service_management with no replacement. |
| 2023.2 | Job variable changes in child workflows | A validation check now prevents parent workflows from running or being saved when job variables in a child workflow don’t match the childJob task. |
| 2023.2 | Merge task variables — null vs. undefined | The handling of null and undefined values in merge and childJob tasks has been standardized. |
| 2023.2 | Message queue libraries removed | RabbitMQ is no longer a dependency. The audit-trail and event-system libraries have been removed, replaced by BullMQ. |
| 2023.2 | Database no longer supports callbacks | The MongoDB Node Driver in the global database variable no longer supports callbacks. Migrate to Promises or async/await. |
| 2023.2 | NSO features removed | The NED Validator has been replaced by a pre-built automation. Commit Queue Manager has been removed with no replacement. |
| 2023.2 | Operations Manager API changes | Job and task APIs no longer return variable data in certain dereference scenarios. The formData wrapper is no longer used by default in trigger APIs. |
| 2023.2 | Inline images removed from pre-built README files | Inline image-src references to the Itential GitLab repository have been removed from pre-built README files. Alt-text renders in their place. |
| 2023.2 | Reserved method output name | The method output name error is now reserved by Itential Platform. Applications or adapters using this name will not start. |
| 2023.2 | Service Manager UI removed | The entire Service Management UI and all app-service_management views have been removed. |
| 2023.2 | Seed scripts removed in Template Builder | Two seed scripts have been removed from app-template_builder. Template seeding is now automatic in Automation Studio. |
| 2023.2 | Task error config option in AG Manager | A new opt-in config option errorOnFailedRequestPreconditions causes IAG tasks to enter the error state when an adapter is offline. This becomes standard behavior in a future release. |
| 2023.2 | Workflow Engine API routes removed | Five WFE APIs deprecated in 2022.1 have been removed. Replacement routes are provided for each. |
| 2023.2.0–2023.2.14 | Transformations using thisArg feature | Transformations using the thisArg feature are incorrectly migrated during upgrade. Upgrade to 2023.2.15 or higher to resolve. |
| 2023.2.28 | Default adapter protocol changing to HTTPS | Adapters published on or after December 1, 2025 default to HTTPS when no protocol is explicitly defined in the service instance configuration. |
