---
title: "Update partner disbursements for a payroll"
method: PATCH
path: "/v1/companies/{company_id}/payrolls/{id}/partner_disbursements"
tags: ["Payrolls"]
---

# Update partner disbursements for a payroll

`PATCH /v1/companies/{company_id}/payrolls/{id}/partner_disbursements`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_id}/payrolls/{id}/partner_disbursements`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/companies/:company_id/payrolls/:id/partner_disbursements/patch.ts> (a function with typed inputs; its response is checked against the schema)

Update partner disbursements for a specific payroll.

scope: `partner_disbursements:write`

## Path parameters

- `company_id` string, required
- `id` string, required

## Headers

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

## Request body

- object
  - `disbursements` object[], required
    - `employee_uuid` string, required: UUID of the employee
    - `payment_method` 'Direct Deposit' | 'Check': Payment method for the employee
    - `payment_status` 'Pending' | 'Paid' | 'Not partner managed' | 'Converted to check': Status of the payment disbursement

## Response `200`

successful

- PayrollPartnerDisbursements: Partner disbursements for a payroll
  - `payroll_uuid` string: The UUID of the payroll
  - `disbursements` object[]: List of disbursements for the payroll
    - `employee_uuid` string: The UUID of the employee
    - `payment_method` 'Direct Deposit' | 'Check': The payment method for the disbursement
    - `payment_status` 'Pending' | 'Paid' | 'Not partner managed' | 'Converted to check': The status of the payment

## Other responses

- `404`: Not Found
- `422`: mixed single and multiple errors example

---

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