GUgusto
Time Off Policies

Update employee time off balances

Updates time off hours balances for employees for a time off policy.

scope: time_off_policies:write

put/v1/time_off_policies/{time_off_policy_uuid}/balance

Request

Path parameters

time_off_policy_uuidstring required

The UUID of the time off policy

Headers

X-Gusto-API-Version'2026-06-15'

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

Request body

Response

successful

uuidstring required

Unique identifier of a time off policy

company_uuidstring required

Unique identifier for the company owning the time off policy

namestring required

Name of the time off policy

policy_type'vacation' | 'sick' | 'bereavement' | 'custom' | 'floating_holiday' | 'jury_duty' | 'learning_and_development' | 'parental_leave' | 'personal_day' | 'volunteer' | 'weather' required

Type of the time off policy. Only "vacation" and "sick" can be created through the API, but other types may be present if the company was previously a Gusto.com customer.

accrual_methodstring required

Policy time off accrual method

accrual_ratestring float nullable

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_unitstring float nullable

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_terminationboolean

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

accrual_waiting_period_daysinteger nullable

Number of days before an employee on the policy will begin accruing time off hours

carryover_limit_hoursstring float nullable

The max number of hours an employee can carryover from one year to the next

max_accrual_hours_per_yearstring float nullable

The max number of hours an employee can accrue in a year

max_hoursstring float nullable

The max number of hours an employee can accrue

policy_reset_datestring nullable

The date the policy resets. Format MM-DD

completeboolean

boolean representing if a policy has completed configuration

versionstring nullable

The current version of the object. See the versioning guide for information on how to use this field. The version will be null if the policy is no longer active.

is_activeboolean required

boolean representing if a policy is active or not

Changes

No recorded changes to this operation across all 2 revisions of this API.