---
title: "Update Invoice Associations"
method: PATCH
path: "/invoice/{invoice_uid}/associations"
---

# Update Invoice Associations

`PATCH /invoice/{invoice_uid}/associations`

## Request

- Base URL: `https://dc-region.zuperpro.com/api`
- URL: `https://dc-region.zuperpro.com/api/invoice/{invoice_uid}/associations`
- Auth: API key in header `x-api-key`

Currently only manages the invoice's linked estimate (quote) — despite the generic name, no job/organization/property association is supported by this endpoint today.

The `estimate_uid` key must be present in the body: a valid estimate uid associates/replaces the link, `null` dissociates it. Omitting the key entirely returns 400. If the given estimate is already the one linked, this is a no-op (200, no `data` object). Otherwise it recomputes the invoice's payment_history/amount_paid/amount_due/invoice_status (merging in any uncollected estimate deposit) and updates both the newly- and previously-linked estimate's conversion state.

## Path parameters

- `invoice_uid` string, required

## Request body

- object
  - `estimate_uid` string, nullable, required: An estimate uid to associate, or null to dissociate the current one. The key must be present even when null.

## Response `200`

200

- object
  - `type` string
  - `message` string
  - `data` object: Omitted when the estimate given was already the linked one (no-op).
    - `invoice_uid` string
    - `invoice_status` string
    - `amount_paid` number
    - `amount_due` number
    - `is_paid` boolean
    - `paid_date` string, nullable
    - `estimate` string, nullable
    - `has_status_changed` boolean

## Other responses

- `400`: 400
- `404`: 404

## Changes

- **2026-11-03** `3c21bc232e16`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zuper/apis/zuper-pro-api/changes/invoice/:invoice_uid/associations/patch.md)

---

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