**版本：202601**

# 更新库存项

**PUT** `/openapi/2026-01/inventory_items/:inventory_item_id`

通过库存项 ID 更新现有库存项的详细信息。

## 请求

**Path参数**

- `inventory_item_id` string (required)

  待更新的库存项 ID

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `inventory_item` object (required)

  待更新的库存项数据

  - `tracking` boolean

    是否启用库存跟踪
  - `tracking_policy` string

    库存跟踪策略

```json
{
  "inventory_item": {
    "tracking": true,
    "tracking_policy": "string"
  }
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `inventory_item` object

    已更新的库存项

    - `id` string

      库存项 ID
    - `product_id` string

      商品 ID
    - `variant_id` string

      子款式 ID
    - `tracking` boolean

      是否启用库存跟踪
    - `tracking_policy` string

      库存跟踪策略
    - `created_at` string

      创建时间，ISO-8601 格式
    - `updated_at` string

      最后更新时间，ISO-8601 格式

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "inventory_item": {
      "id": "string",
      "product_id": "string",
      "variant_id": "string",
      "tracking": true,
      "tracking_policy": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  }
}
```