Open Inventory / Docs
EndpointsPurchasingPurchase ordersOrderid

Update or cancel a purchase order

The API runs on your application instance. Schemas and field names come directly from the OpenAPI specification. Session-authenticated requests require a session on that instance.

PATCH
/purchase-orders/{orderId}

Authorization

bearerAuth
headerAuthorizationBearer <inv_ token>

Path Parameters

orderId*string
Formatuuid

Header Parameters

X-Organization-ID?string

Organization membership selected for this request. User-bound credentials may select any active membership; standalone tokens may only repeat their pinned organization ID.

Formatuuid

Request Body

application/json
  1. body
reference?|
Lengthlength <= 160
supplier?string
Lengthlength <= 240
status?string
Value in"draft""ordered""cancelled"
orderedAt?string
Formatdate-time
expectedAt?|
Formatdate-time
note?string
Lengthlength <= 20000

Response Body

Purchase order updated

Example Request
curl -X PATCH 'https://inventory.example.com/api/v1/purchase-orders/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
Empty