ACC Cost API Enhancement – New GET action-histories Endpoint for Workflow Action Tracking

We’re excited to announce a new addition to the ACC Cost API: the GET action-histories endpoint. This enhancement gives developers and integrators deeper visibility into workflow events across Cost Management, including approvals, rejections, status transitions, and other user-driven actions.

This feature is now available in the ACC/BIM 360 Cost API and can be leveraged immediately.

What Is the New action-histories Endpoint?

The new GET /cost/projects/:projectId/action-histories endpoint returns chronological records of actions performed on cost-related items, such as:

• Contracts
• Supplier Change Orders (SCOs)
• Owner Change Orders (OCOs)
• Pay Applications
• Other workflow-enabled cost objects

Each record provides a detailed snapshot of workflow events, including:

• Action type (e.g., approve, reject, submit, return)
• Item type and item ID
• User who performed the action
• Timestamp
• Status changes
• Comments, if any

This is particularly valuable for building audit logs, compliance workflows, dashboards, and custom approval-tracking tools.

What You Can Do with This Data

With the new endpoint, developers can:

• Build Robust Audit Trails

Track every significant workflow event to meet organizational or legal compliance needs.

• Monitor Contract & SCO Approval Pipelines

Create dashboards that show where items are stuck in a workflow, and who last took action.

• Improve Automation

Trigger downstream processes based on real workflow events—such as updating ERP records when a contract is approved.

• Enhance Project Reporting

Display a chronological activity log of actions taken on any cost item.

API Details

The new endpoint is documented here:

https://aps.autodesk.com/en/docs/bim360/v1/reference/http/cost-action-histories-GET/

The response supports 2 different action history types, here are the examples:

Example response - Normal type:

{
    "results": [
        {
            "associationId": "2a604890-88a9-4ff4-93d0-a0e1fdf0908f",
            "associationType": "Contract",
            "type": "Normal",
            "stepName": null,
            "action": "sendInternal",
            "options": {
                "to": {
                    "status": "sent"
                },
                "from": {
                    "status": "draft"
                }
            },
            "createdAt": "2025-06-03T16:02:07.947Z",
            "operator": {
                "autodeskId": "4V4WKQJGGQ7N",
                "name": "Zhong Wu",
                "email": "zhong.wu@autodesk.com"
            }
        },
        {
            "associationId": "2a604890-88a9-4ff4-93d0-a0e1fdf0908f",
            "associationType": "Contract",
            "type": "Normal",
            "stepName": null,
            "action": "execute",
            "options": {
                "to": {
                    "status": "executed"
                },
                "from": {
                    "status": "sent"
                }
            },
            "createdAt": "2025-06-03T16:04:37.369Z",
            "operator": {
                "autodeskId": "4V4WKQJGGQ7N",
                "name": "Zhong Wu",
                "email": "zhong.wu@autodesk.com"
            }
        }
    ],
    "pagination": {
        "limit": 100,
        "totalResults": 2
    }
}

Example response - Approval type:

{
  "results": [
    {
      "associationId": "1df59db0-9484-11e8-a7ec-7ddae203e404",
      "associationType": "SCO",
      "type": "Approval",
      "action": "review:proceed",
      "operator": {
        "name": "DB cooper",
        "email": "db.cooper@autodesk.com",
        "autodeskId": "FRFNX5QYF6J"
      },
      "options": {
        "stepName": "Internal Review 1",
        "taskDefinitionKey": "UserTask_0",
        "workflowInstanceId": "bff6aa50-2ba4-11f0-92d9-e512a84c9bbc"
      },
      "createdAt": "2019-09-04T01:45:24.582Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "totalResults": 1
  }
}

No Breaking Changes

This is an additive change. Existing integrations continue to work without modification.

You can adopt the new endpoint at your convenience.

If you have feedback or questions about these updates, please feel free to contact APS support.