> ## Documentation Index > Fetch the complete documentation index at: https://api-docs.getmeadow.com/llms.txt > Use this file to discover all available pages before exploring further. # Update purchase order ## OpenAPI ````yaml PUT /api/v1/purchase-orders/{purchaseOrderId} openapi: 3.0.1 info: title: Meadow Open API description: The API to connect to the Meadow platform version: 1.0.0 servers: - url: https://api-staging.getmeadow.com - url: https://api.getmeadow.com security: - meadowConsumer: [] meadowClient: [] paths: /api/v1/purchase-orders/{purchaseOrderId}: put: parameters: - name: purchaseOrderId in: path description: ID of the purchase order to update required: true schema: type: integer format: int64 requestBody: content: application/json: schema: type: object properties: notes: type: string description: Any relevant notes paymentTerms: type: string enum: - net15 - net30 - net60 - cod - custom paymentTermsDueDate: type: string description: >- If payment terms is custom then this field is required. Date formatted as `YYYY-MM-DD` for when payment is due. expectedAt: type: string description: Expected delivery date formatted as `YYYY-MM-DD` externalInvoiceNumber: type: string description: Use this to store a 3rd party ID for the PO inventoryVendorId: type: number description: >- The inventory vendor ID obtained from list or create PO. Alternatively you can use `inventoryVendor.name` inventoryVendor: type: object required: - name properties: name: type: string description: >- name of the vendor. We will match to an existing vendor or create with the below properties if it does not exist. email: type: string description: The email for this vendor phone: type: string description: The phone for this vendor sellerPermitNumber: type: string description: '' notes: type: string description: '' street1: type: string description: '' street2: type: string description: '' postalCode: type: string description: '' city: type: string description: '' state: type: string description: '' lineItems: type: array description: >- The products for this purchase order, This endpoint will update/delete/create ALL of the line items for this purchase order. For that reason, any existing line items you would like to keep must have the id property submitted. Any existing line items, which are not submitted with this endpoint will be deleted. items: type: object required: - productId - amount - costPerUnit properties: id: type: number description: >- If updating an existing line item pass the line item ID from the create, update or list purchase order endpoints. productId: type: number description: The ID of the product to add to the purchase order productOptionId: type: number description: >- The ID of the option that belongs to the product submitted as `productId`. This property is required if the product's `inventoryType` is set to `option`. View more information in our [Inventory Guide](/guides/inventory) amount: type: string description: >- The number of units purchased. Submit as string to avoid floating point errors. costPerUnit: type: string description: >- The cost per unit in dollars. Submit as string to avoid floating point errors. example: lineItems: - productId: 11867 productOptionId: 15472 amount: '35' costPerUnit: '20.35' inventoryVendor: name: Awesome Distribution, Inc. expectedAt: '2024-12-25' responses: '201': description: Update product response content: application/json: schema: $ref: '#/components/schemas/PurchaseOrderResponse' 4XX: description: Unexpected error content: application/json: schema: $ref: '#/components/schemas/APIError' components: schemas: PurchaseOrderResponse: type: object properties: id: type: number description: The ID of the purchase order organizationId: type: number description: The client organization ID status: type: string description: If `closed` no more edits can be made to this PO. enum: - open - closed finalTotal: type: number description: Total in cents for the PO subtotal: type: number description: Total in cents for the PO minus any shipping & handling inventoryVendorId: type: number description: The ID of the inventory vendor lineItems: type: array description: The line items of the purchase order items: type: object properties: product: type: object description: The product for the line item productOption: type: object description: The product option for the line item. finalTotal: type: number description: The total in cents for this line item example: data: createdAt: '2024-12-12T07:53:37.793Z' expectedAt: '2024-12-25' finalTotal: 71225 id: 6741 inventoryVendor: id: 308 organizationId: 25 name: Awesome Distribution, Inc. phone: null notes: null createdAt: '2024-12-12T07:53:37.776Z' updatedAt: '2024-12-12T07:53:37.776Z' archivedAt: null email: null sellerPermitNumber: null street1: null street2: null city: null state: null postalCode: null inventoryVendorId: 308 lineItems: - amount: '35' caExcisePerUnit: '0' costPerUnit: '20.35' createdAt: '2024-12-12T07:53:37.797Z' finalTotal: 71225 id: 33555 product: id: 11867 organizationId: 25 brand: id: 2238 name: Awesome Cannabis createdAt: '2024-12-12T03:08:58.012Z' updatedAt: '2024-12-12T03:08:58.012Z' description: null inventoryType: option createdAt: '2024-12-12T04:08:00.429Z' updatedAt: '2024-12-12T05:06:35.447Z' deletedAt: null description: null isActive: false isFeatured: false name: Blue Dream strainType: hybrid-sativa isCompliant: false unit: gram productId: 11867 productOption: id: 15472 name: Eighth amount: 3.5 price: 4700 salesPrice: null createdAt: '2024-12-12T04:08:00.433Z' updatedAt: '2024-12-12T07:09:11.770Z' upc: null content: '3.5' productOptionId: 15472 subtotal: 71225 updatedAt: '2024-12-12T07:53:37.797Z' organizationId: 25 paymentTermsDueDate: null shippingHandlingFee: 0 status: open subtotal: 71225 totalAmount: '35' updatedAt: '2024-12-12T07:53:37.812Z' APIError: required: - error - message type: object properties: error: type: object properties: message: type: string example: A description of the error code code: type: string example: CODE_OF_ERROR_WILL_BE_HERE securitySchemes: meadowConsumer: type: apiKey name: X-Consumer-Key description: The key assigned to your company and provided via Meadow in: header meadowClient: type: apiKey name: X-Client-Key description: The key generated and provided by our mutual client in: header ````