What parameters does PUT /V1/inventory/stocks/:stockId accept?

This endpoint accepts 1 parameter: stock (Magento\InventoryApi\Api\Data\StockInterface) required.

PUTInventoryApi · Magento 2.4.9 Admin · Magento_InventoryApi::stock_edit

PUT /V1/inventory/stocks/:stockId

Q: What does the PUT /V1/inventory/stocks/:stockId endpoint do in Magento 2?

PUT /V1/inventory/stocks/:stockId is a Magento 2 REST endpoint in the InventoryApi module. Save Stock data. Requires an admin Bearer token with ACL Magento_InventoryApi::stock_edit.

Q: Does PUT /V1/inventory/stocks/:stockId require authentication?

This endpoint requires an admin Bearer token with ACL: Magento_InventoryApi::stock_edit.

PUT /V1/inventory/stocks/:stockId is a Magento 2 REST endpoint in the InventoryApi module. Save Stock data. Requires an admin Bearer token with ACL Magento_InventoryApi::stock_edit.

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

int

Service contract

Magento\InventoryApi\Api\StockRepositoryInterface::save

Authorization

Admin Bearer token with ACL:

Magento_InventoryApi::stock_edit

Body parameters

stock Magento\InventoryApi\Api\Data\StockInterface Required

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Authorization

Bearer <ACCESS_TOKEN> admin token with ACL: Magento_InventoryApi::stock_edit

Path

/V1/inventory/stocks/:stockId

Body

{
  "stock": {
    "extension_attributes": {
      "sales_channels": [
        {
          "code": "",
          "extension_attributes": {},
          "type": ""
        }
      ]
    },
    "name": "",
    "stock_id": 0
  }
}