Cost Management Changelog
Release Date: 2026-10-30
version 1.8.0
Added
- Added a filter (
filter[segmentCode]) to return only items matching specified budget segment codes, for examplefilter[segmentCode]=CSI:03. This filter applies to GET budgets, GET payment-items, GET expenses/:expenseId/items, and GET cost-items. - Added a filter (
filter[budgetId]) to return only payment items that belong to specific budgets. This filter applies to GET payment-items. - Added a filter (
filter[createdAt]) to return only items created within a specified date or date range, for examplefilter[createdAt]=2020-10-31T14:48:00.000Z..2020-11-01T14:48:00.000Z. This filter applies to GET cost-items and GET change-orders/:changeOrder.
Release Date: 2026-05-10
version 1.7.5
Added
- Added
MainContractas a validassociationTypeto GET actions. - Added
draft,pending, andapprovedstatuses to PATCH main-contracts/:id. - Added a field to GET properties that indicates the access level granted to collaborators for a custom attribute (
collaboratorAccess). Possible values:no_access,view,edit.
Release Date: 2026-01-07
version 1.7.4
Removed
- We have removed the following deprecated tutorials:
- Link a Budget to a Contract
- Directly Attach Local Files to Cost Item
- Download a Document Generated from an SCO
Deprecated
- We are deprecating the Retrieve Cost Container ID tutorial. This workflow will not be supported after July 30, 2026. You need to use the project ID instead of the container ID. To obtain the project ID, use GET projects.
Release Date: 2025-11-28
version 1.7.3
Added
- Added 11 new date and time fields to contract endpoints (GET contracts , POST contracts , GET contracts/:id and PATCH contracts/:id) to track key contract lifecycle events:
awardedAt,statusChangedAt,sentAt,respondedAt,responseDue,returnedAt,onsiteAt,offsiteAt,procuredAt,approvedAt, andexecutedAt. - Added two new budget code fields to GET payment-items:
budgetCode(unformatted) andbudgetFormattedCode(formatted with separators for readability). - The
mainContractIdfield is now editable in PATCH expenses/:id, allowing expenses to be reassigned to different main contracts.
Release Date: 2025-9-11
version 1.7.2
Added
Added a new comments field to the GET change-orders/:changeOrder and GET change-orders/:changeOrder/:id endpoints. This field returns the list of comments associated with a change order.
Release Date: 2025-8-10
version 1.7.1
Added
Added a new GET action-histories endpoint to the Cost API for retrieving workflow action histories. This endpoint returns records of actions taken on cost-related items, such as contracts or SCO, including approvals and status changes.
Release Date: 2025-3-21
version 1.7.0
Added
Added new endpoints to the Cost Management service to manage sub cost items. These endpoints support retrieval, creation, update, deletion, and copying operations.
For more information, see Sub Cost Items API.
Release Date: 2024-12-10
version 1.6.3
Added
Added a new GET taxes endpoint to support taxes in the Cost Management service. Taxes can be associated with change orders, cost items, expenses, and payments.
Release Date: 2024-11-20
Version 1.6.2
Removed
We have removed the deprecated method for linking budgets to contracts. The budgets object is no longer supported in POST Contracts and PATCH Contracts.
To link budgets to contracts, use POST budgets-contracts:link instead.
Release Date: 2024-11-12
Version 1.6.1
Added
Added a new cost items endpoint to create multiple cost items in a single request, with a limit of 200 items per request.
Release Date: 2024-09-12
version 1.6.0
Added
- Added support for integrating Cost Management with external ERP systems. This feature enables developers to synchronize budgets, contracts, main contracts, main contract items, cost items, expenses, expense items, change orders, schedules of value, payment(readonly) and payment item(readonly) with external ERP systems.
New fields have been added to facilitate this integration: externalSystem, externalId, externalMessage, lastSyncTime, and integrationState. See GET/PATCH/POST request endpoints for more details.
Note: externalSystem, externalId, externalMessage, lastSyncTime, and integrationState also appear in payments and payment items related endpoints. They are not currently relevant but are included for future use. The integrationState field is not yet available for schedules of values but will be supported soon.
- Added a new tutorial Integrating Cost Management with External Systems that demonstrates how to integrate a budget between an external ERP system and the Cost Management service.
Release Date: 2024-04-21
Version 1.5.0
Added
- Added a new `contracts </en/docs/bim360/v1/reference/http/cost-budgets-contractslink-POST>`_endpoint for batch linking and unlinking of multiple budgets to multiple contracts.
- Added a new tutorial Link Budgets to a Contract that outlines the workflow for retrieving a list of budgets and contracts, and for linking and unlinking multiple budgets to multiple contracts.
Deprecated
We are deprecating the current method of linking budgets to contracts. Currently, you can only link budgets to a single contract in one API call. We have added a new endpoint that supports linking multiple budgets to multiple contracts. See above for more details.
We are deprecating this feature that is part of PATCH contracts/:contractId. Note that we are only deprecating this feature. We are not deprecating the endpoint.
Release Date: 2023-09-08
Version 1.4.0
Added
Added endpoints for performance tracking items, performance tracking item instances, and timesheets:
- Create, read, and delete performance tracking items.
- Create, read, update, and delete performance tracking item instances.
- Create, read, update, and delete timesheets.
Release Date: 2023-07-25
Version 1.3.0
Added
Added endpoints for main contracts and main contract items:
- Read, create, update, and delete main contracts.
- Read, create, update, and delete main contract items.
Release Date: 2023-05-23
Version 1.2.0
Added
Added endpoints for schedule of values, expenses, expense items, payments, and payment items:
- Read, create, update, and delete schedule of values (SOV) items.
- Read, create, update, and delete expenses.
- Read, create, update, and delete expense items.
- Read payments and payment items.
Release Date: 2023-01-30
Version 1.1.0
Added Webhooks Support
The Webhooks service listens for events that are triggered by various parts of the APS ecosystem, and notifies your application that the events have occurred so you can direct the application to respond accordingly.
This update enables Cost Management to trigger any of 43 different Webhook events to which your application can subscribe, such as when a budget is created or a contract is updated. You use the Webhooks API to configure a hook that will listen for the event you specify. When an event is triggered, the Webhooks service sends a notification to a callback URL that you have defined.
For details, see the Cost API Field Guide.
Removed Deprecated File Packages Endpoint: 2022-05-30
We have removed the deprecated File Packages endpoint. To retrieve file packages, use GET documents.