BAbamboohr
Time Off
Public API

Assign Time Off Policies (v1.1)

Changed on

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

put/api/v1_1/employees/{employeeId}/time_off/policies

Request

Path parameters

employeeIdinteger required

The internal employee ID of the employee whose time off policies are being assigned.

Request body

timeOffPolicyIdinteger required

The ID of the time off policy to assign.

accrualStartDatestring 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}.

Example request

[
  {
    "timeOffPolicyId": 4,
    "accrualStartDate": "2024-02-01"
  },
  {
    "timeOffPolicyId": 5,
    "accrualStartDate": null
  }
]

Response

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

timeOffPolicyIdinteger

The ID of the assigned time off policy.

timeOffTypeIdinteger

The ID of the time off type.

accrualStartDatestring date nullable

The date accruals started in YYYY-MM-DD format. Null for manual and unlimited policy types.

Changes

  • 922fc15f43a7Revision changes
    • info

      api operation id assign-time-off-policies-v1-1 removed and replaced with assign-time-off-policies-v1_1