> This page is for version v2 (default).
> For other versions, use one of these documentation indexes:
> - v2 (default): https://autodesk-poc.ferndocs.com/v2/llms.txt
> - v1: https://autodesk-poc.ferndocs.com/v1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://autodesk-poc.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://autodesk-poc.ferndocs.com/_mcp/server.

# Create a Potential Change Order (PCO)

Creating a potential change order (PCO) is the beginning of the change process in BIM 360 cost management. This tutorial demonstrates how to create a PCO for a project.

## Before You Begin

* [Register an app](https://aps.autodesk.com/myapps)
* Acquire a [3-legged OAuth token](https://aps.autodesk.com/en/docs/oauth/v2/tutorials/get-3-legged-token/) with the `data:write` scope.
* Verify that you have access to the relevant BIM 360 account and BIM 360 project.
* Retrieve the project ID for your project. To obtain a project ID, use [GET projects](https://aps.autodesk.com/en/docs/bim360/v1/reference/http/admin-accounts-accountidprojects-GET/).

## Step 1: Create a PCO

Use the container ID you retrieved in the first tutorial (`be00f32e-c03c-4c7b-9ec4-d2614bf1980c` in this example) to call [POST change-orders/pco](https://aps.autodesk.com/en/docs/bim360-private/v1/reference/http/cost-change-orders-changeOrder-POST/).

### Request

```bash
curl "https://developer.api.autodesk.com/cost/v1/containers/be00f32e-c03c-4c7b-9ec4-d2614bf1980c/change-orders/pco" -d '{
  "name":"Revised Main Entrance Layout per ASI 002",
  "description": "Revised Main Entrance Layout per ASI 002",
  "scope":"out",
  "type":"Owner Change Order",
  "sourceType":"ASI",
  "sourceRef": "ASI 002"
}' -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer XZvCJNhdxESsBRIH28MfLf2hKL5O"
```

### Response

```json
{
  "id": "f5c7869f-faa1-4418-b8e6-e7c23c495560",
  "number": "(0001)",
  "name": "Revised Main Entrance Layout per ASI002",
  "scope": "out",
  "description": "Revised Main Entrance Layout per ASI 002",
  "estimated": 0,
  "proposed": 0,
  "submitted": 0,
  "approved": 0,
  "committed": 0,
  "properties": [{
    "name": "Source Type",
    "value": "ASI",
  }, {
    "name": "Source Ref",
    "value": "ASI 002",
  }, {
    "name": "Type",
    "value": "Owner Change Order",
  }]
}
```

This example returns the PCO ID `f5c7869f-faa1-4418-b8e6-e7c23c495560`. You can use a PCO ID later to get the latest status of the PCO. For example, for this ID you would call [GET change-orders/pco/f5c7869f-faa1-4418-b8e6-e7c23c495560](https://aps.autodesk.com/en/docs/bim360-private/v1/reference/http/cost-change-orders-changeOrder-id-GET/).

## Step 2: Create a Cost Item

You can create cost items to break down change if necessary. Use the container ID you used before (`be00f32e-c03c-4c7b-9ec4-d2614bf1980c`) and the PCO ID you just retrieved (`f5c7869f-faa1-4418-b8e6-e7c23c495560`) to call [POST cost-items](https://aps.autodesk.com/en/docs/bim360-private/v1/reference/http/cost-cost-items-POST/).

### Request

```bash
curl "https://developer.api.autodesk.com/cost/v1/containers/be00f32e-c03c-4c7b-9ec4-d2614bf1980c/cost-items" -d '{
  "name":"Revised Main Entrance Layout per ASI 002 - Labor",
  "description": "Labor",
  "changeOrderId": "f5c7869f-faa1-4418-b8e6-e7c23c495560"
}' -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer XZvCJNhdxESsBRIH28MfLf2hKL5O"
```

### Response

```json
{
  "id": "f5c7869f-faa1-4418-b8e6-e7c23c495560",
  "number": "0001",
  "name": "Revised Main Entrance Layout per ASI 002 - Labor",
  "scope": "out",
  "description": "Labor",
  "estimated": 0,
  "proposed": 0,
  "submitted": 0,
  "approved": 0,
  "committed": 0,
}
```

To create more cost items for this PCO, repeat step 2.

Congratulations! You have created a PCO with a cost item in BIM 360 cost management. A cost engineer can use this to start the change process in cost management. It allows you to estimate, quote and review the changes. Later you can call [GET change-orders/pco/f5c7869f-faa1-4418-b8e6-e7c23c495560](https://aps.autodesk.com/en/docs/bim360-private/v1/reference/http/cost-change-orders-changeOrder-id-GET/) to get the latest status and cost(`estimated`, `proposed`, `submitted`, `approved`, `committed`) of this change.

---

*Imported from the Autodesk Platform Services documentation: [https://aps.autodesk.com/en/docs/acc/v1/tutorials/cost/create-pco](https://aps.autodesk.com/en/docs/acc/v1/tutorials/cost/create-pco).*