---
title: "Update partner disbursements for a contractor payment group"
method: PATCH
path: "/v1/contractor_payment_groups/{id}/partner_disbursements"
tags: ["Contractor Payment Groups"]
---

# Update partner disbursements for a contractor payment group

`PATCH /v1/contractor_payment_groups/{id}/partner_disbursements`

Update partner disbursements for a specific contractor payment group.

scope: `partner_disbursements:write`

## Path parameters

- `id` string, required

## Headers

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

## Request body

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

## Response `200`

successful

- ContractorPaymentGroupPartnerDisbursements — Partner disbursements for a contractor payment group
  - `contractor_payment_group_uuid` string — The UUID of the contractor payment group
  - `disbursements` object[] — List of disbursements for the contractor payment group
    - `contractor_payment_uuid` string — The UUID of the contractor payment
    - `contractor_uuid` string — The UUID of the contractor
    - `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` — Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

[API](https://skmtc.dev/gusto/apis/gusto-api.md) · [All operations](https://skmtc.dev/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)