> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.itential.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.itential.com/_mcp/server.

# Breaking changes

> Index of all breaking changes introduced in the Itential Platform 2023.2 release.

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](./breaking-changes/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](./breaking-changes/audit-trail-collection-removed)                                | The `audit_trail` MongoDB collection has been removed. No replacement is available.                                                                                                          |
| 2023.2             | [Broken references](./breaking-changes/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](./breaking-changes/data-path-prop-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](./breaking-changes/default-adapter-protocol-changed-to-https)                           | The default protocol for Adapters has changed from HTTP to HTTPS                                                                                                                             |
| 2023.2             | [DryRun and View DryRun manual tasks removed](./breaking-changes/dryrun-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](./breaking-changes/help-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](./breaking-changes/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](./breaking-changes/itential-platform-key-removed-global-config) | The `iap` key has been removed from the global config object available to custom apps and adapters.                                                                                          |
| 2023.2             | [Itential Tools updated](./breaking-changes/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](./breaking-changes/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](./breaking-changes/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](./breaking-changes/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](./breaking-changes/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](./breaking-changes/mongo-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](./breaking-changes/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](./breaking-changes/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](./breaking-changes/removed-inline-images)                      | 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](./breaking-changes/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](./breaking-changes/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](./breaking-changes/template-seed-scripts-removed-2023-2)                | 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](./breaking-changes/task-error-config-option-in-ag-manager)                | A new opt-in config option `errorOnFailedRequestPreconditions` causes Gateway 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](./breaking-changes/workflow-engine-api-routes-removed-2023-2)                 | 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](./breaking-changes/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](./adapter-default-http-protocol-changing)                             | Adapters published on or after December 1, 2025 default to HTTPS when no protocol is explicitly defined in the service instance configuration.                                               |