Sign in

v1

latestOpenAPI 3.1.02026-07-26294215839.4 KB
Time Off
Public API

Assign Time Off Policies (v1.1)

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

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

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.