---
title: "Updates a Supplement"
method: PUT
path: "/api/2026-10-01/resources/payroll/supplements/{id}"
tags: ["Payroll > Supplement"]
---

# Updates a Supplement

`PUT /api/2026-10-01/resources/payroll/supplements/{id}`

## Request

- Base URL: `https://api.factorialhr.com`
- URL: `https://api.factorialhr.com/api/2026-10-01/resources/payroll/supplements/{id}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://id.factorialhr.com/oauth/authorize`
    - Token URL: `https://id.factorialhr.com/api/oauth/token` scopes: `payroll_supplements`
  - API key in header `x-api-key`

Updates a Supplement unless it is an additional compensation supplement (In such case, you need to create a new one, then remove the old compensation supplement from the contract and add the newly created one to it).

## Path parameters

- `id` string, required

## Request body

- object
  - `id` string, required: The supplement id
  - `employee_id` string: The employee id of the supplement
  - `contracts_compensation_id` string: The supplement contract compensation id
  - `contracts_taxonomy_id` string: The supplement contract taxonomy id
  - `amount_in_cents` integer: Supplement amount in cents
  - `effective_on` string: Supplement effective on date following the format YYYY-MM-DD
  - `unit` string: Supplement unit
  - `payroll_policy_period_id` string: Supplement payroll policy period id

## Response `200`

OK

- PayrollSupplement
  - `id` string, required: The identifier of the supplement
  - `employee_id` string, required: The identifier of the employee associated with the supplement
  - `company_id` string, required: The identifier of the company associated with the supplement
  - `contracts_compensation_id` string: The contract compensation identifier associated with the supplement
  - `contracts_taxonomy_id` string: The taxonomy identifier associated with the supplement
  - `amount_in_cents` integer: The amount of the supplement in cents
  - `unit` 'money' | 'units' | 'time', required: The unit of the supplement
  - `effective_on` string: The date on which the supplement becomes effective
  - `created_at` string: The created at date when the supplement was created
  - `updated_at` string: The last updated at date when the supplement was last updated
  - `description` string: The description of the supplement
  - `payroll_policy_period_id` string: The payroll policy period identifier associated with the supplement
  - `employee_observations` string[]: Observations on the employee made by the admin or manager
  - `raw_minutes_in_cents` integer: The raw value of minutes in cents associated with the supplement
  - `minutes_in_cents` integer: The value of minutes in cents after adjustments
  - `equivalent_minutes_in_cents` integer: The equivalent value of minutes in cents for payroll processing
  - `currency` string: The currency used for the supplement, typically in ISO 4217 format
  - `legal_entity_id` string: The legal entity identifier associated with the supplement

## Changes

- **2026-11-03** `83ac9aa1de50`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/factorialhr/apis/factorial-api/changes/api/2026-10-01/resources/payroll/supplements/:id/put.md)

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)