Update Time Tracking Project

patch

https://{companyDomain}.bamboohr.com/api/v1/time-tracking/projects/{id}

Partially updates a time tracking project identified by its ID. Only fields provided in the request body are updated; omitted fields are left unchanged.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

integer

required

The project ID.

Body Params

Data contract for partially updating a time tracking project. All fields are optional; only fields present in the request body will be updated.

name

string

The name of the project.

billable

boolean

Whether or not the project is billable.

includeInPayroll

boolean

Whether hours logged to this project will show in payroll and payroll reports.

allEmployeesAssigned

boolean

Whether all time & attendance employees are assigned or not.

archived

boolean

Whether or not the project is archived.

employeeIds

array of integers

Array of employee IDs to assign to the project. Replaces the current assignment list when present; an empty array clears all assignments.

employeeIds

hasTasks

boolean

Toggles whether time is logged directly to the project (false) or to specific tasks on the project (true). Setting to true requires the project to already have at least one active task; setting to false leaves existing tasks unchanged.

Responses

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successfully updated the project.

400Malformed request body.

401Unauthorized. Missing or invalid authentication.

403Forbidden. Insufficient permissions.

404Project not found.

409A project with the supplied name already exists.

422Validation error (e.g., invalid projectId, no fields provided, invalid types, or setting hasTasks=true on a project with no active tasks).