ACC Cost Management: Budgets-Contracts Link API

We are pleased to inform you about the availability of a new API endpoint to link multiple budgets to multiple contracts for Cost Management in Autodesk Build.

This is an enhancement to the existing functionality; till now, you had to specify contact-budget links during the creation of a contract or while updating a contract. Now, with the new API, you can create multiple links using a single endpoint, making easier to use:

POST v1/containers/{containerId}/budgets-contracts:link

The following code demonstrates a sample usage for creating and removing links in one call:

curl -v 'https://developer.api.autodesk.com/cost/v1/containers/e94b9bc8-1775-4d76-9b1d-c613e120ccff/budgets-contracts:link' \
  -X 'POST' \
  -H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a' \
  -H 'Content-Type: application/json' \
  -d '{
        "create": [
          {
            "contractId": "226449d0-9481-11e8-87fb-215990a8aeb3",
            "budgetId": "f77f7cfa-47a4-41d4-be49-dafc92202903"
          }
        ],
        "remove": [
          {
            "contractId": "d241d341-eb21-4893-b21f-3152d6db4faa",
            "budgetId": "0d760290-a82b-41ac-9e62-aa70b7217d42"
          }
        ]
      }'

This endpoint is compatible for ACC and BIM 360.

Note: currently, this endpoint does not allow linking the same budget to multiple contracts in a single API call. You’ll need to call this API multiple times to link the same budget to multiple contracts.

For the detail of usage, please take a look at the new tutorial: