---
title: "Partial update item"
method: PATCH
path: "/items/{id}/"
tags: ["Items"]
---

# Partial update item

`PATCH /items/{id}/`

Endpoint for partially updating an existing item.

## Path parameters

- `id` string, required

## Headers

- `X-Wafeq-Idempotency-Key` string

## Request body

- PatchedItem — Shared validation and save logic for item_units_of_measure across v1 and v2 serializers.
  - `created_ts` string, date-time — The timestamp in UTC when the item was created
  - `description` string — The description of the item.
  - `expense_account` string, nullable — The expense account for this item.
  - `external_id` string — External identifier for the item.
  - `id` string — The unique identifier of the item.
  - `is_active` boolean — Whether the item is active.
  - `is_tracked_inventory` boolean — Whether inventory is tracked for this item.
  - `item_units_of_measure` ItemUnitOfMeasureWrite[] — The units of measure for this item.
    - `conversion_factor` number, double, required — The conversion factor relative to the base unit.
    - `is_active` boolean — Whether this unit of measure is active.
    - `is_base` boolean — Whether this is the base unit of measure for the item.
    - `is_default_purchase` boolean — Whether this is the default unit for purchases.
    - `is_default_sales` boolean — Whether this is the default unit for sales.
    - `unit_cost` number, double, nullable — The unit cost for this unit of measure.
    - `unit_of_measure` string, required — The unique identifier of the unit of measure.
    - `unit_price` number, double, nullable — The unit price for this unit of measure.
  - `legacy_id` string — [Deprecated] The legacy identifier of the item.
  - `modified_ts` string, date-time — The timestamp in UTC when the item was last modified
  - `name` string — The name of the item.
  - `purchase_tax_rate` string, nullable — The tax rate applied when purchasing this item.
  - `quantity_on_hand` number, double, nullable — The current quantity on hand. Only relevant for tracked inventory items.
  - `revenue_account` string, nullable — The revenue account for this item.
  - `revenue_tax_rate` string, nullable — The tax rate applied when selling this item.
  - `sku` string — The SKU of the item.
  - `tax_authority` ApiV1DocumentItemTaxAuthority
    - `metadata` ApiV1DocumentItemTaxAuthorityMetadata
      - `default_exemption_reason` string, nullable
  - `unit_cost` number, double, nullable — The default unit cost of the item if no unit of measure is specified.
  - `unit_price` number, double, nullable — The default unit price of the item if no unit of measure is specified.

## Response `200`

- Item — Shared validation and save logic for item_units_of_measure across v1 and v2 serializers.
  - `created_ts` string, date-time, required — The timestamp in UTC when the item was created
  - `description` string — The description of the item.
  - `expense_account` string, nullable — The expense account for this item.
  - `external_id` string — External identifier for the item.
  - `id` string, required — The unique identifier of the item.
  - `is_active` boolean — Whether the item is active.
  - `is_tracked_inventory` boolean — Whether inventory is tracked for this item.
  - `item_units_of_measure` ItemUnitOfMeasureWrite[] — The units of measure for this item.
    - `conversion_factor` number, double, required — The conversion factor relative to the base unit.
    - `is_active` boolean — Whether this unit of measure is active.
    - `is_base` boolean — Whether this is the base unit of measure for the item.
    - `is_default_purchase` boolean — Whether this is the default unit for purchases.
    - `is_default_sales` boolean — Whether this is the default unit for sales.
    - `unit_cost` number, double, nullable — The unit cost for this unit of measure.
    - `unit_of_measure` string, required — The unique identifier of the unit of measure.
    - `unit_price` number, double, nullable — The unit price for this unit of measure.
  - `legacy_id` string, required — [Deprecated] The legacy identifier of the item.
  - `modified_ts` string, date-time, required — The timestamp in UTC when the item was last modified
  - `name` string, required — The name of the item.
  - `purchase_tax_rate` string, nullable — The tax rate applied when purchasing this item.
  - `quantity_on_hand` number, double, nullable, required — The current quantity on hand. Only relevant for tracked inventory items.
  - `revenue_account` string, nullable — The revenue account for this item.
  - `revenue_tax_rate` string, nullable — The tax rate applied when selling this item.
  - `sku` string — The SKU of the item.
  - `tax_authority` ApiV1DocumentItemTaxAuthority
    - `metadata` ApiV1DocumentItemTaxAuthorityMetadata
      - `default_exemption_reason` string, nullable
  - `unit_cost` number, double, nullable — The default unit cost of the item if no unit of measure is specified.
  - `unit_price` number, double, nullable — The default unit price of the item if no unit of measure is specified.

---

[API](https://skmtc.net/wafeq/apis/wafeq-public-api.md) · [All operations](https://skmtc.net/wafeq/apis/wafeq-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wafeq/wafeq-public-api/revisions/36816b4fce7f/schema)