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

# Upsert par levels

> Bulk-upserts par levels for a given store. Items in the payload are created or updated; items not in the payload are left unchanged.

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

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

<ParamField body="store_id" type="string" required>
  UUID of the store for these par levels.
</ParamField>

<ParamField body="levels" type="object[]" required>
  Par level entries (at least 1):

  <Expandable title="level entry fields">
    <ParamField body="item_id" type="string" required>UUID of the item.</ParamField>
    <ParamField body="par_qty_base" type="number" required>Target stock quantity in the item's base unit (must be > 0). Use `0` to effectively zero out an item's par.</ParamField>
    <ParamField body="metadata" type="object">Free-form extra data.</ParamField>
  </Expandable>
</ParamField>

<ResponseField name="items" type="object[]">
  All upserted par level records with full detail.
</ResponseField>

<RequestExample>
  ```json theme={null}
  {
    "store_id": "str_main_01...",
    "levels": [
      {
        "item_id": "itm_chicken_01...",
        "par_qty_base": 10000
      },
      {
        "item_id": "itm_rice_01...",
        "par_qty_base": 5000
      }
    ]
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "id": "par_01...",
        "account_id": "acc_01...",
        "vendor_id": "vnd_01...",
        "store_id": "str_main_01...",
        "item_id": "itm_chicken_01...",
        "par_qty_base": 10000,
        "metadata": {},
        "created_at": "2026-08-01T00:00:00.000Z",
        "updated_at": "2026-08-07T14:00:00.000Z"
      },
      {
        "id": "par_02...",
        "account_id": "acc_01...",
        "vendor_id": "vnd_01...",
        "store_id": "str_main_01...",
        "item_id": "itm_rice_01...",
        "par_qty_base": 5000,
        "metadata": {},
        "created_at": "2026-08-07T14:00:00.000Z",
        "updated_at": "2026-08-07T14:00:00.000Z"
      }
    ]
  }
  ```
</ResponseExample>