---
title: "Changes to Update a payroll by ID"
method: PUT
path: "/v1/companies/{company_id}/payrolls/{payroll_id}"
---

# Changes to Update a payroll by ID

`PUT /v1/companies/{company_id}/payrolls/{payroll_id}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `f98575fa2a5e`: 2 breaking, 2 warning, 6 info

## Changes

- **2026-11-03** `f98575fa2a5e`: 2 breaking, 2 warning, 6 info
  - the response property `pay_period/end_date` became nullable for the status `200`
  - the response property `pay_period/start_date` became nullable for the status `200`
  - removed the optional property `errors/items/errors` from the response with the `409` status
  - removed the optional property `errors/items/metadata` from the response with the `409` status
  - added the new optional request property `employee_compensations/items/fixed_compensations/items/breakdowns`
  - added the new optional request property `employee_compensations/items/hourly_compensations/items/breakdowns`
  - added the optional property `employee_compensations/items/allOf[#/components/schemas/Payroll-Employee-Compensations-Base-Type]/fixed_compensations/items/breakdowns` to the response with the `200` status
  - added the optional property `employee_compensations/items/allOf[#/components/schemas/Payroll-Employee-Compensations-Base-Type]/hourly_compensations/items/breakdowns` to the response with the `200` status
  - added the optional property `employee_compensations/items/allOf[#/components/schemas/Payroll-Employee-Compensations-Base-Type]/paid_time_off/items/approved_request_hours` to the response with the `200` status
  - added the optional property `workweeks` to the response with the `200` status

---

[Operation](https://skmtc.dev/gusto/apis/gusto-api/docs/v1/companies/:company_id/payrolls/:payroll_id/put.md) - [API](https://skmtc.dev/gusto/apis/gusto-api.md) - [Page](https://skmtc.dev/gusto/apis/gusto-api/changes/v1/companies/:company_id/payrolls/:payroll_id/put)