---
title: "Update Employee Enrollment"
method: PATCH
path: "/api/v1/time-tracking/employees/{employeeId}"
tags: ["Time Tracking", "Public API"]
---

# Update Employee Enrollment

`PATCH /api/v1/time-tracking/employees/{employeeId}`

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/time-tracking/employees/{employeeId}`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `/authorize.php`
    - Token URL: `/token.php` scopes: `time_tracking:employees.write`
- TypeScript: <https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/time-tracking/employees/:employeeId/patch.ts> (a function with typed inputs; its response is checked against the schema)

Enables, disables, or reassigns a single employee's enrollment using JSON Merge Patch (RFC 7396) semantics: only the properties present in the body are applied and omitted properties are unchanged. Content-Type must be `application/merge-patch+json`. When the employee has no enrollment record yet and `enabled` is set to true, one is created. `timezone` and `clockInId` are read-only on this API. Reassigning an employee whose time tracking is currently off requires setting `enabled` to true in the same body, and `configurationId` and `enabledOn` cannot be combined with `enabled: false`.

OAuth Scopes: time_tracking:employees.write

## Path parameters

- `employeeId` integer, required

## Request body

- TimeTrackingUpdateEmployeeTimeTrackingDataV1: JSON Merge Patch body for an employee time tracking enrollment. Every property is optional; omitted properties are unchanged.
  - `enabled` boolean: True to enable time tracking for the employee, false to disable it. Disabling retains the enrollment record for history.
  - `configurationId` integer, nullable: The configuration to enroll the employee in. Null falls back to the company's GLOBAL configuration. Cannot be sent in the same body that sets enabled to false.
  - `enabledOn` string, date: Effective date for the enable, in YYYY-MM-DD format. Only honored while enabled is being set to true; defaults to today.

## Response `200`

The updated employee time tracking enrollment.

- TimeTrackingEmployeeTimeTrackingDataV1: An employee's time tracking enrollment.
  - `id` integer: The ID of the enrollment record.
  - `employeeId` integer: The ID of the employee.
  - `configurationId` integer, nullable: The ID of the time tracking configuration the employee is enrolled in. Null means the employee falls back to the company's GLOBAL configuration.
  - `enabled` boolean: Whether the employee is enrolled in time tracking.
  - `enabledOn` string, date, nullable: The date time tracking was enabled for the employee, in YYYY-MM-DD format. Null if never enabled.
  - `timezone` string, nullable: The IANA timezone used for this employee's time tracking. Read-only on this API. Null when the employee has no enabled timezone.
  - `clockInId` integer, nullable: The kiosk / badge clock-in ID for this employee. Unique per company. Read-only on this API.
  - `createdAt` string, date-time: ISO 8601 timestamp when the enrollment record was created.
  - `updatedAt` string, date-time, nullable: ISO 8601 timestamp when the enrollment record was last updated.

## Other responses

- `400`: Malformed request body.
- `401`: Unauthorized. Missing or invalid authentication.
- `403`: Forbidden. Insufficient permissions.
- `404`: The employee does not exist, or has no enrollment record to disable.
- `415`: Unsupported media type. Content-Type must be application/merge-patch+json.
- `422`: Validation error (e.g., an unknown configurationId, an invalid enabledOn, an attempt to write a read-only field, or an employee who cannot be enabled).

## Changes

- **2026-11-03** `922fc15f43a7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bamboohr/apis/bamboohr-api/changes/api/v1/time-tracking/employees/:employeeId/patch.md)

---

[API](https://skmtc.dev/bamboohr/apis/bamboohr-api.md) - [All operations](https://skmtc.dev/bamboohr/apis/bamboohr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bamboohr/apis/bamboohr-api/revisions/922fc15f43a7?raw)