---
title: "Update an item"
method: PUT
path: "/companies/{companyId}/items/{itemId}"
tags: ["items"]
---

# Update an item

`PUT /companies/{companyId}/items/{itemId}`

Update an existing item for the company.

**Scope:** `items:write`

## Request body

- union
  - object
    - `id` string, uuid, nullable — Should not be set for new items
    - `description` string, required
    - `itemType` 'salesItem', required
    - `productType` 'goods' | 'services', required
    - `unitType` 'unspecified' | 'piece' | 'hour' | 'day' | 'month' | 'kilogram' | 'gram' | 'liter' | 'meter' | 'centimeter' | 'millimeter' | 'meterSquared' | 'meterCubic' | 'mile' | 'kilometer' | 'gigabyte' | 'hectar' | 'words' | 'year' | 'week' | 'minute' | 'megabyte' | 'ton', required
    - `unitPrice` number, double, required
    - `taxRate` number, double, required
    - `bookkeepingAccountNumber` integer, nullable — The bookkeeping account number for this item. If not set, the account will be automatically selected based on the item productType, taxRate, customer and company settings.
  - object
    - `id` string, uuid, nullable — Should not be set for new items
    - `description` string, required
    - `itemType` 'descriptionOnlyItem', required

## Response `200`

Item updated

- union
  - object
    - `id` string, uuid, nullable — Should not be set for new items
    - `description` string, required
    - `itemType` 'salesItem', required
    - `productType` 'goods' | 'services', required
    - `unitType` 'unspecified' | 'piece' | 'hour' | 'day' | 'month' | 'kilogram' | 'gram' | 'liter' | 'meter' | 'centimeter' | 'millimeter' | 'meterSquared' | 'meterCubic' | 'mile' | 'kilometer' | 'gigabyte' | 'hectar' | 'words' | 'year' | 'week' | 'minute' | 'megabyte' | 'ton', required
    - `unitPrice` number, double, required
    - `taxRate` number, double, required
    - `bookkeepingAccountNumber` integer, nullable — The bookkeeping account number for this item. If not set, the account will be automatically selected based on the item productType, taxRate, customer and company settings.
  - object
    - `id` string, uuid, nullable — Should not be set for new items
    - `description` string, required
    - `itemType` 'descriptionOnlyItem', required

## Other responses

- `400` — Missing required information

---

[API](https://skmtc.net/bokio/apis/company-api.md) · [All operations](https://skmtc.net/bokio/apis/company-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bokio/company-api/revisions/1bb5d09ce15e/schema)