Sign in

v3

latestSwagger 2.02026-08-067506752.0 MB
timeOffPolicy

Update an existing time off policy

patch/v1/org/{orgId}/timeoff/policy/{policyId}

Path parameters

orgIdstring required

Org identifier (either id or slug)

policyIdstring required

TimeOff id

Request body

namestring

Internal policy name

displayNamestring

External policy name displayed to users

descriptionstring

Policy description

guidelinesstring

Policy guidelines

type'PTO' | 'TOIL' | 'VACATION' | 'SICK' | 'MEDICAL' | 'JURY' | 'OFFSITE' | 'PARENTAL' | 'UNPAID' | 'DISABILITY_SHORT' | 'DISABILITY_LONG' | 'BEREAVEMENT' | 'MILITARY' | 'RELIGIOUS' | 'VOTING' | 'VOLUNTEER' | 'UNKNOWN'

Type of policy to be created

status'ACTIVE' | 'INACTIVE'

Status of the policy

allocationType'UPFRONT' | 'UNLIMITED' | 'ACCRUAL'

Whether the time off is accrued, received upfront, or is an unlimited policy

annualAllocationnumber

Number of days allocated annually

maxConsecutiveDaysPerRequestnumber

An optional max number of days allowed per request

minBalancenumber

An optional minimum balance

enableCarryOverBalanceboolean

Enable carry over balance.

maxCarryOverBalancenumber

An optional maximum carry over balance

carryOverExpirationDatestring

Month and day of carry over expiration.

carryOverExpirationMonthsinteger

Months after carry over date that carry over expires.

enablePartialDayRequestsboolean

Allow half day requests

partialDayGranularitynumber

Partial day requests can only be made down to this level of granularity (i.e. request % granularity == 0)

enablePartialDayPeriodboolean

Allow specifying periods of time (e.g. AM, PM) for partial days

disableRequestsboolean

Whether to disable time off requests for this policy

noteRequiredboolean

Whether a note is required for time off requests

filterstring

CQL used to determine which jobs the policy applies to

holidayCalendarIdstring

an associated holiday calendar, days on this calendar are not deducted from the time off balance

respectPersonCalendarboolean

when true, a holiday calendar applied to the person via calendar eligibility takes precedence over this policy's holidayCalendarId

disableProratedAllocationboolean

whether limited allocation policies are prorated based on person start date

prorationRounding'UP' | 'NEAREST' | 'HALF'

rounding method for prorating calculations

yearStartDatestring

Month and day of policy year rollover. Defaults to January 1.

policyFromDatestring date

The date on which this policy's balance/accrual settings come into effect. The policy may have entries before this date, but it will not generate e.g. accrual entries.

policyUntilDatestring date

The first date after this policy's balance/accrual settings end (i.e. the exclusive end date). The policy may have entries after this date, but it will not generate e.g. accrual entries.

workDaysstring[]

Days of the week that count against the time off balance. Defaults to Monday through Friday if not set.

Example request

{
  "name": "US Part-Time/Intern",
  "displayName": "PTO",
  "description": "Annual sick days allotted to employees",
  "holidayCalendarId": "588f7ee98f138b19220041a7",
  "policyEvents": [
    {
      "groupId": "588f7ee98f138b19220041a7",
      "title": "Tenure milestones"
    }
  ]
}

Response

no content