PATCH /v1/items/{id}/stock

Scope

write_items

Name	In	Type	Required	Description
`id`	path	integer	required	item_id
`Idempotency-Key`	header	string	required	冪等キー（必須・ADR-010）。UUID v4 推奨。同一キー再送は保存レスポンスを再生
`inventory`	body	integer	optional	絶対値 SET（0〜99999）。adjustment と排他
`adjustment`	body	integer	optional	増減値（負=減算）。結果が負 or 上限超過は 422。inventory と排他

{
  "item_id": 0,
  "inventory": 0,
  "previous_inventory": 0
}

商品在庫を更新する（絶対値 SET / 増減・同期直行・行ロック）(write_items)

{
  "error": {
    "code": "insufficient_scope",
    "message": "requires scope 'read_orders'",
    "request_id": "req_01H..."
  }
}

Possible errors: 401 / 403 / 404 / 422 / 503