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

# Assign Time Off Policies (v1)

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

## Request

- Base URL: `https://companySubDomain.bamboohr.com`
- URL: `https://companySubDomain.bamboohr.com/api/v1/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/employees/:employeeId/time_off/policies/put.ts> (a function with typed inputs; its response is checked against the schema)

> **Deprecated.**

Deprecated. Use **Assign Time Off Policies (v1.1)** instead (`assign-time-off-policies-v1_1`). Assigns time off policies to an employee with accruals starting on the specified date. A null start date removes the existing assignment. On success, returns the current list of assigned policies.

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. Set to null to remove an existing assignment.

## Response `200`

The current list of assigned policies for the employee.

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

## Other responses

- `400`: Invalid request. Possible causes: employee not found, missing hire date, malformed JSON, missing timeOffPolicyId, or a policy is already assigned for the time off 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, for example because of EOR restrictions.

---

[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)