Updates an Allowance

put

https://api.factorialhr.com/api/2026-04-01/resources/timeoff/allowances/{id}

Updates an existing Time Off Allowance

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

Body Params

integer

required

accrued_denominator_in_cents

integer

Only for Allowances based on worked time. It represents how many units you need to work to be granted allowance units

accrued_factor_in_cents

integer

Only for Allowances based on worked time. It represents how many units you are given per unit of time worked

available_days

string

enum

Indicates how the allowance units are accrued. For example all_days means all allowance days are given on the first day of the cycle.

carry_over_units_in_cents

integer

How many units can carry over between cycles multiplied by 100

count_holiday_as_workable

boolean

This setting flags if units taken during a bank holiday should be deducted or not from allowance.

days_type

string

enum

Indicates if the allowance is based on working on calendar days.

Allowed:

expire_in_months

integer

When does the carryover expire in months.

frequency

string

enum

Defines duration of the allowance cycles. Can be "yearly", "monthly_flexible" or "lifetime"

Allowed:

holiday_allowance_in_cents

integer

Base amount of holiday allowance units multiplied by 100

leave_type_ids

array of integers

An array of leave type ids associated with that allowance

leave_type_ids

maximum_amount_in_cents

integer

Maximum the allowance can reach on accrued

name

string

Allowance name set by the user

negative_counter_type

string

enum

Whether the allowance allows to request more days than available.

Allowed:

position

integer

Indicates the position in the allowance when rendering them in UI

proration_type

string

enum

Whether the allowance has proration enabled or not.

Allowed:

pto_proratio_enabled

boolean

Whether the allowance days are prorated or not

range_type

string

enum

Configures how leaves duration is handled.

Allowed:

rounding

string

enum

How the accrued units of the allowance are rounded. It depends if the allowance is set in hours or days.

Allowed:

tenure_period_transition

string

enum

In case the allowance has tenure periods, when is this tenure applied.

Allowed:

tenure_periods_enabled

boolean

Whether the allowance has tenure periods enabled or not.

tenure_periods

array

The tenure periods associated with the allowance.

tenure_periods

unlimited_accrued_hours

boolean

Flag to indicate if there is unlimited accrual.

unlimited_carry_over

boolean

Flag to indicate if there is unlimited carry over.

unlimited_carry_over_expiration

boolean

Boolean to flag if carryover does not expire

unlimited_holidays

boolean

Flag to indicate that the allowance has unlimited available days

Response

200OK