This article lists breaking API changes and provides guidance for how to handle the updates. Breaking changes are API updates that could cause client applications (such as custom integrations) to fail. Although we try to avoid making breaking changes, they are sometimes necessary in order to address critical issues, align API features with ongoing product changes, or improve API performance.
Before a breaking API change is made, affected customers will be notified in advance. Information about the breaking change will also be added to this article. If you have any questions, please reach out to Customer Success or Kantata Support.
For a full list of API changes, including non-breaking changes, please see the Kantata OX Release Notes.
Acceptable date format changing to ISO 8601 for all date and date-time request fields — Starting October 2023
All date and date-time request fields will be standardized to accept only ISO 8601 formatted dates (e.g.
The timeline for this change is as follows:
- Starting October 2023, all new accounts must use ISO 8601 format.
- Existing accounts have a 6 month period to transition to ISO 8601 format.
- By May 2024, all accounts must use ISO 8601 format.
Examples of date formats that will not be accepted after the change:
|Invalid Date Format||Reason||Valid Date Format|
||Missing colons in time.||
||Time zone offset should be colon-separated.||
||Datetime should be colon-separated.||
||Month should be double digits.||
||Extraneous trailing content after timestamp.||
||AM/PM is not supported in ISO 8601.||
Review your logic and update all date and date-time request fields to ISO 8601 format.
Temporary deprecation of time_administration_candidates filter for GET api/v1/users - March 21, 2023
On March 21, 2023, the
time_administration_candidates filter for the
GET api/v1/users endpoint will be temporarily deprecated. We are temporarily deprecating this filter to improve its performance.
If you are using this filter, please update your logic and remove any usage of the filter. The behavior of the deprecated filter is not guaranteed during the deprecation period. The results of this filter can be recreated by using the
GET api/v1/timesheet_submissions endpoint with filters, including setting the query parameter
On July 5, 2022, the date format of several date properties within custom field value Subscribed Events will be changed to the ISO 8601 standard (e.g. "2022-05-18T12:34:29-06:00").
The following date properties will be affected:
created_atproperty which appears within
updated_atproperty which appears within
valueproperty which appears within
custom_field_valuesfor Date custom fields
The following event types will be affected:
If you are parsing any of the affected date properties, please update your logic to parse dates in the ISO 8601 format instead.
user_can_edit removed from default response of GET api/v1/time_entries and GET api/v1/expenses — February 14, 2022
After February 14, 2022, the
user_can_edit field will no longer be included in the responses of the
GET api/v1/time_entries and
GET api/v1/expenses endpoints by default. We are making this change to improve the performance of these endpoints.
user_can_edit field indicates whether the current user can edit a time entry or expense. This is a value that Kantata OX does not display in the UI, nor surface in any of our pre-packaged integrations. However, as a Kantata OX API consumer, you may have asked for this value in a custom integration that you created.
If you have a custom integration that relies on the
user_can_edit field, please check the following:
- Do you parse the
user_can_editJSON? If you are not currently parsing that field, you don’t have to do anything.
- If you are parsing the
user_can_editJSON, you have two options:
- If you are not using the value anywhere else in your code, stop parsing that field.
- Add the following parameter to any
GETrequest made to either