Create or process Product Update Stock
Post /api/vendor-product/update-stock
Authentication: Vendor bearer token required for protected operations; verify exact permission decorator in controller.
Feature area: Inventory
Implementation source: src/api/vendor/controllers/ProductController.ts
Request example provenance: Source-defined in UpdateStockRequest.
Response example provenance: Illustrative response envelope only. This route inventory does not include its route-specific @apiSuccessExample; response fields and messages must be verified in the matching controller/service. The example is intended to show the common response-wrapper style, not to define a guaranteed response schema.
Example status: Illustrative. The example is included to demonstrate request/response shape in the reference UI; verify the owning controller and request DTO before using it as a contract.
Authorizations
Body
Body uses UpdateStockRequest. productId is validated as non-empty; nested stock settings are defined by the ProductStock interface. The handler expects productStock entries for SKU stock settings.
Response
Successful response. Illustrative response envelope only. This route inventory does not include its route-specific @apiSuccessExample; response fields and messages must be verified in the matching controller/service. The example is intended to show the common response-wrapper style, not to define a guaranteed response schema. Example is illustrative and does not guarantee a stable response contract.