---
title: "Assign Time Off Policies (v1.1)"
method: PUT
path: "/api/v1_1/employees/{employeeId}/time_off/policies"
tags: ["Time Off", "Public API"]
---

# Assign Time Off Policies (v1.1)

`PUT /api/v1_1/employees/{employeeId}/time_off/policies`

## Request

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

Assigns time off policies to an employee with accruals starting on the specified date. On success, returns the current list of assigned policies including manual and unlimited policy types.

OAuth Scopes: time_off.write

## Path parameters

- `employeeId` integer, required

## Request body

- object[]
  - `timeOffPolicyId` integer, required: The ID of the time off policy to assign.
  - `accrualStartDate` string, date, nullable, required: The date accruals should start in YYYY-MM-DD format. To remove an existing assignment, use DELETE /api/v1/employees/{employeeId}/time-off/policies/{assignmentId}.

## Response `200`

The current list of assigned policies for the employee, including manual and unlimited types.

- object[]
  - `timeOffPolicyId` integer: The ID of the assigned time off policy.
  - `timeOffTypeId` integer: The ID of the time off type.
  - `accrualStartDate` string, date, nullable: The date accruals started in YYYY-MM-DD format. Null for manual and unlimited policy types.

## Other responses

- `400`: Invalid request. Possible causes: malformed JSON, missing required fields, missing hire date, or duplicate policy type.
- `401`: Unauthorized. Invalid API credentials.
- `403`: Insufficient permissions to assign time off policies.
- `422`: Unprocessable entity. The operation is not allowed for this employee, such as an employer of record or a contractor time off policy.
- `500`: Internal server error.

## Changes

- **2026-11-03** `922fc15f43a7`: 1 info
  - api operation id `assign-time-off-policies-v1-1` removed and replaced with `assign-time-off-policies-v1_1`

[Operation history](https://skmtc.dev/bamboohr/apis/bamboohr-api/changes/api/v1_1/employees/:employeeId/time_off/policies/put.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)