---
title: "Update Time Tracking Task"
method: PATCH
path: "/api/v1/time-tracking/tasks/{id}"
tags: ["Time Tracking", "Public API"]
---

# Update Time Tracking Task

`PATCH /api/v1/time-tracking/tasks/{id}`

Partially updates a time tracking task identified by its ID. Only fields provided in the request body are updated; at least one field must be provided.

OAuth Scopes: time_tracking:project.write

## Path parameters

- `id` integer, required

## Request body

- ProjectUpdateTimeTrackingProjectTaskV1 — Payload to partially update a task on a time tracking project. All fields are optional; at least one field must be provided.
  - `name` string — Display name of the task.
  - `billable` boolean — Whether hours on this task are billable.

## Response `200`

Task updated.

- ProjectTimeTrackingTaskV1 — A task within a time tracking project. Tasks are sub-organizational units used to further classify hours worked.
  - `id` integer — The ID of the task.
  - `name` string — The name of the task.
  - `projectId` integer — The ID of the project this task belongs to.
  - `billable` boolean — Whether the task is billable.
  - `createdAt` string, date-time, nullable — ISO 8601 timestamp when the task was created.
  - `updatedAt` string, date-time, nullable — ISO 8601 timestamp when the task was last updated.
  - `deletedAt` string, date-time, nullable — ISO 8601 timestamp when the task was deleted.

## Other responses

- `403` — Forbidden.
- `404` — Task not found.
- `409` — Duplicate task name within the project.
- `422` — Validation error.

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)