Breaking Changes
  • 19 Nov 2025
  • 1 Minute to read
  • Dark
    Light

Breaking Changes

  • Dark
    Light

Article summary

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

QR Code for Microsoft Form

Last Update: November 2025

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.

VersionChangeDescriptionMethodStandard PatchCloud Release DateReference
AllError MessagesStandard http codes and error messagesALL23Q2 2026Best 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.

VersionChangeDescriptionMethodStandard PatchCloud Release DateReference
1Corrected ViewAdded syscontextGET21May 31, 2025UKG Pay Header

Vertex Location by City

Endpoint: hcm-rest-api/rest/1/vertexloccity
Notes: Enhanced view to allow passing user sys context.

VersionChangeDescriptionMethodStandard PatchCloud Release DateReference
1Modified finder attributesloczipcodestart, loczipcodeendGET21May 31, 2025Vertex Location 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.

VersionChangeDescriptionMethodStandard PatchCloud Release DateReference
1Removed AttributesTshCertSeq, TshIuCreateDate, TshIuLastUpdateDate, TshIuUpdateDate, TshPciLineUuid, TshSeqNo, TshUserField1, TshUserField2, TshUserField3, TshWbsSetupFlag, TshWbsvCode1, TshWbsvCode2, TshWbsvCode3, TshWbsvCode4All21May 31, 2025Payroll Timesheet

Project Controls

Assign Cost Codes

Endpoint: jc-rest-api/rest/1/jcjobcostcodes
Notes: Modified to remove Company Name and Job Name to optimize.

VersionChangeDescriptionMethodStandard PatchCloud Release DateReference
1Removed AttributeGjcatCompName, GjcatJobNameGET22Nov. 15, 2025Job Cost Codes (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.

VersionChangeDescriptionMethodStandard PatchCloud Release DateReference
1Removed FindersselectCostCatCodes: phaseDate, selectByphaseDate: phaseDateGET22Nov. 15, 2025PCI Detail

Core System

System User

Endpoint: sys-rest-api/rest/1/sduser
Notes: API depreciated.

VersionChangeDescriptionMethodStandard PatchCloud Release DateReference
1DepreciatedReplaced with API User.All22Nov. 15, 2025User