--- title: "Breaking Changes" slug: "cloud-breaking-changes" updated: 2026-05-08T20:17:17Z published: 2026-05-08T20:17:17Z canonical: "developers.cmicglobal.com/cloud-breaking-changes" --- > ## Documentation Index > Fetch the complete documentation index at: https://developers.cmicglobal.com/llms.txt > Use this file to discover all available pages before exploring further. # Breaking Changes ## Stay In the Loop Sign up to receive email notifications about upcoming updates, releases, or changes. Click subscribe or scan the QR code below. [Subscribe](https://forms.cloud.microsoft/r/vsb9ds0iEm) ![QR Code for Microsoft Form](https://cdn.document360.io/fb2f8da1-4f36-47a5-aa2b-f649dbc152cd/Images/Documentation/QRCode%20for%20Subscribe%20for%20Cloud%20Release%20Notifications.png) Last Update: May 2026 ## Accounts Payable AP Voucher Endpoint: **ap-rest-api/rest/1/apvoucher** **Notes:** Enhancements to existing AP Voucher API to expand attributes and modify data type for VouNum attribute under header and detail. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Data type | VouNum: integer ApVoucherDetailViewObj: VdistVouNum: integer | ALL | Nexus 1 (23) | May 16, 2026 | [Retrieve a Specific AP Voucher By Voucher Number](https://developers.cmicglobal.com/apidocs/retrieve-a-specific-ap-voucher-by-voucher-number) | --- AP Registered Invoices Endpoint: **ap-rest-api/rest/1/apreginvdetails** **Notes:** Fixed back-end validation. When inserting PO invoices through the API, system-generated distributions using a sub-ledger control account will continue without validation, but any selected sub-ledger account for overwrite—either for non-PO invoices or when overriding a PO invoice distribution—will now trigger validation and be blocked. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Enhancement | Modified back-end logic | POST | 22 | January 17, 2026 | [UKG Pay Header](https://developers.cmicglobal.com/apidocs/retrieve-pay-headers) | ## Project Management PM User Role Endpoint: **pm-rest-api/rest/1/pmuserrole** **Notes:** Enhanced API pagination rules to its original state. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Enhanced API | Enhanced API pagination rules to its original state | GET | Nexus 1 (23) | May 16, 2026 | [Retrieve a Specific PM User Role By Code](https://developers.cmicglobal.com/apidocs/retrieve-a-specific-pm-user-role-by-code) | --- PM Project Endpoint: **pm-doc-rest-api/rest/v1/pmproject** **Notes:** Removed unnecessary attributes form the primary key constraint in the PmprojectsecV entity object. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Removed Finder Attributes | PrimaryKey: PmpCompCode, PmpProjName, PmpProjCode | GET | Nexus 1 (23) | May 16, 2026 | [Create a PM Project](https://developers.cmicglobal.com/apidocs/create-a-pm-project) | --- Subcontract Schedules Endpoint: **pm-rest-api/rest/1/scsched** **Notes:** Added uuid as primary key instead of composite key usage. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Changed Attribute Type | Changed from composite PK to uuid PK | ALL | Nexus 1 (23) | May 16, 2026 | [Retrieve SC Details By Code](https://developers.cmicglobal.com/apidocs/retrieve-sc-details-by-code) | ## Asset Management Inventory Endpoint: **ci-rest-api/rest/1/ciitem** **Notes:** This endpoint will be depreciated as of Nexus 2 (Patch 24) | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Depreciated | Version 2 released on Nexus 1 | GET | Nexus 2 (24) | November 2026 | [Inventory Item](https://developers.cmicglobal.com/apidocs/retrieve-inventory-items-by-code-1) | ## All APIs Centralized API Exception Handling Endpoints: **Applies to all APIs** Notes: Effective Nexus 1, CMiC has introduced centralized error handling across all APIs. This ensures every API response follows a consistent, structured JSON format, making errors easier to trace, debug, and handle across all services. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | All | Error Messages | Standard http codes and error messages | ALL | Nexus 1 (23) | Q2 2026 | [Best Practice - Global API Exception Handling](https://developers.cmicglobal.com/v1/docs/best-practice-global-api-exception-handling) | ## Human Capital Management --- United Kingdom Payroll Endpoint: **hcm-rest-api/rest/1/ukgpayheader** **Notes:** Modified to return the correct primary keys for employee check number in response. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Corrected View | Added syscontext | GET | 21 | May 31, 2025 | [UKG Pay Header](https://developers.cmicglobal.com/apidocs/retrieve-pay-headers) | --- Vertex Location by City Endpoint: **hcm-rest-api/rest/1/vertexloccity** **Notes:** Enhanced view to allow passing user sys context. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Modified finder attributes | loczipcodestart, loczipcodeend | GET | 21 | May 31, 2025 | [Vertex Location Code](https://developers.cmicglobal.com/apidocs/retrieve-security-groups-by-code) | --- Payroll Timesheets Endpoint: **hcm-rest-api/rest/1/pyemptimesheet** **Notes:** Modified to be system-calculated (from workcompcode, job, phase, and category) instead of passed in the payload, resolving miscalculation issues from duplicate fields. Also, cleaned up duplicate and non-functioning attributes. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Removed Attributes | TshCertSeq, TshIuCreateDate, TshIuLastUpdateDate, TshIuUpdateDate, TshPciLineUuid, TshSeqNo, TshUserField1, TshUserField2, TshUserField3, TshWbsSetupFlag, TshWbsvCode1, TshWbsvCode2, TshWbsvCode3, TshWbsvCode4 | All | 21 | May 31, 2025 | [Payroll Timesheet](https://developers.cmicglobal.com/apidocs/create-a-py-employee-timesheet) | ## Project Controls JC Forecast Archives Endpoint: **jc-rest-api/rest/1/jccontforecastarch** **Notes:** Enhanced API to support vuuid and new parameter orderBy=default. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Enhanced API | Added JccfVUuid and ?orderBy=default | GET | Nexus 1 (23) | May 16, 2026 | [Retrieve a Specific JC Forecast Archives By Code](https://developers.cmicglobal.com/apidocs/retrieve-a-specific-jc-forecast-archives-by-code) | --- PCI Headers Endpoint: **cm-rest-api/rest/1/cmmast** **Notes:** CmdQuotedBudgAmt attribute type is converted to Big Decimal. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Changed Attribute Type | CmdQuotedBudgAmt attribute type changed to java.math.BigDecimal | ALL | Nexus 1 (23) | May 16, 2026 | [Retrieve PCI Masters By Code](https://developers.cmicglobal.com/apidocs/retrieve-pci-masters-by-code) | --- PCI Details Endpoint: **cm-rest-api/rest/1/cmdetail** **Notes:** CmdQuotedBudgAmt attribute type is converted to Big Decimal. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Changed Attribute Type | CmdQuotedBudgAmt attribute type changed to java.math.BigDecimal | ALL | Nexus 1 (23) | May 16, 2026 | [Job Cost Codes (Job Phases)](https://developers.cmicglobal.com/apidocs/create-a-jc-job-cost-code-job-phases) | --- Assign Cost Codes Endpoint: **jc-rest-api/rest/1/jcjobcostcodes** **Notes:** Modified to remove Company Name and Job Name to optimize. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Removed Attribute | GjcatCompName, GjcatJobName | GET | 22 | Nov. 15, 2025 | [Job Cost Codes (Job Phases)](https://developers.cmicglobal.com/apidocs/create-a-jc-job-cost-code-job-phases) | --- Change Items (PCI/OCO) Endpoint: **cm-rest-api/rest/1/cmdetail** **Notes:** Removed 'Phasedate' parameter from finders, to standardize with other API finders. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Removed Finders | selectCostCatCodes: phaseDate, selectByphaseDate: phaseDate | GET | 22 | Nov. 15, 2025 | [PCI Detail](https://developers.cmicglobal.com/apidocs/retrieve-pci-details-by-code) | ## Core System Users Endpoint: **sys-rest-api/jersey/v1/users?compCode={compCode}&createDate={createDate}&empNo={empNo}&userId={userId}** **Notes:** Removed attributes on the DB functional layer and added attributes partner type and permission template. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Removed Attributes | items[i]: partnerType, permissionTemplate | GET | Nexus 1 (23) | May 16, 2026 | [Retrieve Users By Company Code, User ID, Employee No and Created Date](https://developers.cmicglobal.com/apidocs/retrieve-users-by-company-code-user-id-employee-no-and-created-date) | System User Endpoint: **sys-rest-api/rest/1/sduser** **Notes:** API depreciated. | Version | Change | Description | Method | Standard Patch | Cloud Release Date | Reference | | --- | --- | --- | --- | --- | --- | --- | | 1 | Depreciated | Replaced with API User. | All | 22 | Nov. 15, 2025 | [User](https://docs.cmicglobal.com/portal/Content/E_Reference_Material/SD_-_System_Data/Reference/Security/User_Maintenance.htm?Highlight=User%20maintenance) |