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

# Update item

> Partially updates an item. Only the fields you send are changed. unit_group_id and base_unit_id cannot be changed after creation.

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

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

<ParamField path="itemId" type="string" required>
  Item UUID.
</ParamField>

<ParamField body="name" type="string">
  New display name.
</ParamField>

<ParamField body="type" type="string">
  New item type (`INGREDIENT`, `PACKAGING`, `SUPPLY`, `PREPARED_ITEM`, `FINISHED_GOOD`).
</ParamField>

<ParamField body="procurement_type" type="string">
  New procurement type (`PURCHASED`, `PRODUCED`, `PURCHASED_AND_PRODUCED`).
</ParamField>

<ParamField body="is_inventory_tracked" type="boolean">
  Toggle stock tracking.
</ParamField>

<ParamField body="count_frequency" type="string | null">
  New count cycle (`DAILY`, `WEEKLY`, `MONTHLY`, or `null`).
</ParamField>

<ParamField body="metadata" type="object">
  Replaces the existing metadata object entirely.
</ParamField>

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

<RequestExample>
  ```json theme={null}
  {
    "name": "All-purpose flour (premium)",
    "count_frequency": "DAILY",
    "external_user_id": "user_jane_42"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": "itm_01j5k...",
    "account_id": "acc_01j...",
    "external_item_id": "SKU-001",
    "code": "FLOUR-KG",
    "name": "All-purpose flour (premium)",
    "type": "INGREDIENT",
    "procurement_type": "PURCHASED",
    "unit_group_id": "ug_mass_01...",
    "base_unit_id": "unit_g_01...",
    "is_inventory_tracked": true,
    "is_active": true,
    "count_frequency": "DAILY",
    "metadata": {},
    "created_at": "2026-01-10T09:00:00.000Z",
    "updated_at": "2026-08-07T15:00:00.000Z"
  }
  ```

  ```json 404 theme={null}
  {
    "error": {
      "kind": "item_not_found",
      "message": "Item not found"
    }
  }
  ```
</ResponseExample>