Update a time off policy

put

https://api.gusto-demo.com/v1/time_off_policies/{time_off_policy_uuid}

scope: time_off_policies:write

Path Params

time_off_policy_uuid

string

required

The UUID of the time off policy

Body Params

version

string

required

The current version of the object. See the versioning guide for information on how to use this field.

name

string

Name of the time off policy

policy_type

string

enum

Type of the time off policy. Currently only "vacation" and "sick" are supported

Allowed:

accrual_method

string

enum

Accrual method of the time off policy

accrual_rate

string | null

The rate at which the time off hours will accrue for an employee on the policy. Represented as a float, e.g. "40.0".

accrual_rate_unit

string | null

The number of hours an employee has to work or be paid for to accrue the number of hours set in the accrual rate. Only used for hourly policies (per_hour_paid, per_hour_paid_no_overtime, per_hour_work, per_hour_worked_no_overtime). Represented as a float, e.g. "40.0".

paid_out_on_termination

boolean

Boolean representing if an employee's accrued time off hours will be paid out on termination

accrual_waiting_period_days

integer | null

Number of days before an employee on the policy will begin accruing time off hours. If accrual_method is per_anniversary_year, per_calendar_year, or unlimited, then accrual_waiting_period_days should be 0.

carryover_limit_hours

string | null

The max number of hours an employee can carryover from one year to the next. If accrual_method is unlimited, then carryover_limit_hours must be blank.

max_accrual_hours_per_year

string | null

The max number of hours an employee can accrue in a year. If accrual_method is yearly (per_anniversary_year, per_calendar_year) or unlimited, then max_accrual_hours_per_year must be blank.

max_hours

string | null

The max number of hours an employee can accrue. If accrual_method is unlimited, then max_hours must be blank.

policy_reset_date

string | null

The date the policy resets. Format MM-DD

complete

boolean

boolean representing if a policy has completed configuration

Headers

X-Gusto-API-Version

string

enum

Defaults to 2026-02-01

Determines the date-based API version associated with your API call. If none is provided, your application's minimum API version is used.

Allowed:

Responses

200successful

404Not Found

422Unlimited Policy updated with accrual rate