Sign in

v1

latestOpenAPI 3.1.02026-07-26294215839.4 KB
Time Off
Public API

Assign Time Off Policies (v1)

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

put/api/v1/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.

timeOffPolicyIdinteger

The ID of the assigned time off policy.

timeOffTypeIdinteger

The ID of the time off type.

accrualStartDatestring date

The date accruals started in YYYY-MM-DD format.