---
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`

> **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.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)