> ## 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.

# Close purchase order

> Closes the purchase order lifecycle. The body requires external_user_id for audit.

<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.
</ParamField>

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

<ParamField body="external_user_id" type="string" required>
  The human actor for audit. Required on close.
</ParamField>

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

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

<ResponseExample>
  ```json 200 theme={null}
  {
    "purchase_order": {
      "id": "po_01j5k...",
      "status": "CLOSED",
      "closed_at": "2026-08-15T10:00:00.000Z"
    }
  }
  ```
</ResponseExample>