> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Confirm purchase order

> Moves a purchase order from SUBMITTED to CONFIRMED status, indicating the supplier acknowledged it.

<ParamField header="x-api-key" type="string" required>
  API key with `inventory:write` scope.
</ParamField>

<ParamField path="vendorId" type="string" required>
  Vendor UUID.
</ParamField>

<ParamField path="orderId" type="string" required>
  Purchase order UUID. Must be in `SUBMITTED` status.
</ParamField>

<ParamField query="action" type="string" required>
  Must be `confirm`.
</ParamField>

<ParamField body="external_user_id" type="string">
  Actor for audit trail.
</ParamField>

<ResponseField name="purchase_order" type="object">
  Updated purchase order with `status: "CONFIRMED"`.
</ResponseField>

<RequestExample>
  ```json theme={null}
  {
    "external_user_id": "user_purchasing_01"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "purchase_order": {
      "id": "po_01j5k...",
      "status": "CONFIRMED",
      "confirmed_at": "2026-08-12T09:00:00.000Z"
    }
  }
  ```
</ResponseExample>