Update Inventory Item

Update an existing inventory item's identifier.

Endpoint

PUT /v1/store-products/{id}/inventory-items/{itemId}

Authentication

Requires an API key with the store:write scope.

Parameters

Parameter	Type	Location	Description
id	integer	path	The store product ID
itemId	integer	path	The inventory item ID

Request Body

Field	Type	Required	Description
identifier	string|null	No	Updated identifier for the item (max 255 characters)
location_id	integer|null	No	Supplier location ID to assign (see Locations)

Response

Success (200 OK)

{
  "data": {
    "id": 1,
    "store_product_id": 5,
    "store_product_variation_id": null,
    "identifier": "WIDGET-UPDATED",
    "unique_identifier": "INV-00001",
    "total_quantity": 1,
    "supplier_location": {
      "id": 2,
      "name": "Manly Branch"
    },
    "has_barcode": true,
    "created_at": "2026-02-13T12:00:00+00:00",
    "updated_at": "2026-02-13T14:00:00+00:00"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-13T14:00:00+00:00"
  }
}

Errors

Status	Code	Description
401	authentication_required	No API key provided
401	invalid_api_key	Invalid API key
403	insufficient_scope	API key lacks store:write scope
404	resource_not_found	Store product or inventory item does not exist
422	validation_error	Invalid request body
422	inventory_error	Business logic error

Example Request

curl -X PUT "https://app.equipdash.com/api/v1/store-products/5/inventory-items/1" \
  -H "Authorization: Bearer eqd_live_abc123xyz789..." \
  -H "Content-Type: application/json" \
  -d '{
    "identifier": "WIDGET-UPDATED"
  }'