---
title: "Update purchase orders"
method: PATCH
path: "/api/v2/purchase_orders"
tags: ["Purchase Orders - Bulk"]
---

# Update purchase orders

`PATCH /api/v2/purchase_orders`

Bulk-updates multiple purchase orders in a single request. Accepts a JSON:API array of partial `purchase_orders` resources keyed by ID.

## Headers

- `X-Organization-Id` string, required

## Response `200`

Paginated list of purchase orders in JSON:API format, with related vendor, deal, creator, document type, bill-to, bill-from, and attachment resources available via `include`.

## Changes

- **2026-08-27** `bbf5057edf0d` — 1 breaking, 1 warning
  - the `data` request property type changed from `object` to `array`
  - removed the request property `data/attributes`
- **2026-08-26** `c5790dcc537a` — 1 breaking, 1 info
  - the `data` request property type changed from `array` to `object`
  - added the new optional request property `data/attributes`
- **2026-08-24** `4438d43d6b96` — 1 breaking, 1 warning
  - the `data` request property type changed from `object` to `array`
  - removed the request property `data/attributes`
- **2026-08-20** `8395135d78da` — 1 breaking, 1 info
  - the `data` request property type changed from `array` to `object`
  - added the new optional request property `data/attributes`
- **2026-08-19** `13b96987f294` — 1 breaking, 1 warning
  - the `data` request property type changed from `object` to `array`
  - removed the request property `data/attributes`

[Full history](https://skmtc.dev/productive/apis/api-documentation/changes/api/v2/purchase_orders/patch.md)

---

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