> This page is for version v1.
> 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.

# Update Existing Timesheets

This tutorial demonstrates how to update existing timesheets. The steps include finding the timesheet ID and updating the timesheet.

Note that the Cost API timesheets endpoints used in this tutorial are designed only for use with a third party timesheet reporting (tracking) app (e.g. Riskcast, Rhumbix, QuickBooks Time, or ClickUp) that you’ve integrated with Cost Management.

## 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 `data:create`, `data:read`, and `data:write` scopes.
* Verify that you have access to the relevant BIM 360 account and 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: Find the Timesheet ID

To retrieve the ID of the timesheet you want to update, call [GET time-sheets](https://aps.autodesk.com/en/docs/acc/v1/reference/http/cost-time-sheets-GET/). In this example, assume that the project container ID is `e94b9bc8-1775-4d76-9b1d-c613e120ccff`.

### Request

```bash
curl -X GET 'https://developer.api.autodesk.com/cost/v1/containers/e94b9bc8-1775-4d76-9b1d-c613e120ccff/time-sheets?filter[budgetCode]=84720010121001FEE&filter[endDate]=2022-05-06' -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6Imp3dF9zeW1tZXRyaWNfa2V5In0'
```

### Response

```json
{
    "pagination": {
        "limit": 20,
        "offset": 0,
        "totalResults": 100,
        "nextUrl": "..."
    },
    "results": [
        {
            "id": "6f7f7780-3867-4aa3-9f37-8ae53532a590",
            "containerId": "e94b9bc8-1775-4d76-9b1d-c613e120ccff",
            "trackingItemInstanceId": "1df59db0-9484-11e8-a7ec-7ddae203e404",
            "startDate": "2020-01-06",
            "endDate": "2020-05-06",
            "inputQuantity": "100",
            "outputQuantity": "50",
            "creatorId": "GF8XKPKWM38E",
            "changedBy": "GF8XKPKWM38E",
            "createdAt": "2020-01-06T01:24:22.678Z",
            "updatedAt": "2020-05-06T01:00:12.989Z"
        }
    ]
}
```

Find the timesheet you want to update and note the timesheet ID (`6f7f7780-3867-4aa3-9f37-8ae53532a590`).

## Step 2: Update the Timesheet by ID

To update the timesheet, use the timesheet ID (`6f7f7780-3867-4aa3-9f37-8ae53532a590`) to call [PATCH time-sheets/:id](https://aps.autodesk.com/en/docs/acc/v1/reference/http/cost-time-sheets-id-PATCH/). Provide updated values for any of the endpoint’s request payload fields.

### Request

```bash
curl -X PATCH 'https://developer.api.autodesk.com/cost/v1/containers/e94b9bc8-1775-4d76-9b1d-c613e120ccff/time-sheets/6f7f7780-3867-4aa3-9f37-8ae53532a590'
\ -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6Imp3dF9zeW1tZXRyaWNfa2V5In0'
\ -H 'Content-Type: application/json'
\ -d '{
        "inputQuantity": 100,
        "outputQuantity": 2
      }'
```

### Response

```json
{
    "id": "6f7f7780-3867-4aa3-9f37-8ae53532a590",
    "startDate": "2022-05-06",
    "endDate": "2022-05-06",
    "inputQuantity": 100,
    "inputUnit": "hr",
    "outputQuantity": 2,
    "outputUnit": "ea",
    "trackingItemInstanceId": "1df59db0-9484-11e8-a7ec-7ddae203e404"
}
```

Your timesheet has been updated with the new input and output quantities.

---

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