Products
Update Product
Learn how to update products using the endpoint PUT /stores//products/.
PUT
Update product
📌 Endpoint
PUT /stores/{storeId}/products/{productId}
Updates the data of an existing product.
🔐 Authentication
- Private route.
- Requires header
Authorizationwith your API key and active plan.
🧾 Route parameters
🧍 Body (JSON)
All fields are optional (sendingnull leaves the field unchanged), but must follow the rules below when sent:
name(3-32)image(string up to 512 characters; sending""clears the image, whilenullleaves it unchanged)description(12-256)categoryIds(array of category IDs from the store)delivery(DIGITALorPHYSICAL)price(0.5 to 9999)stock(integer -1 to 9999,-1unlimited)disabled(trueorfalse)position(integer greater than or equal to 1)metadata(object)
✅ Example request
Standard snippet (cURL)
Use the cURL example from the Request example section above as the official snippet.📦 Success response (200)
⚠️ Possible errors
400 INVALID_DATA→ invalid body, parameters, orcategoryIdsitem400 INVALID_DATA_NAME_MIN→nameshorter than 3 characters400 INVALID_DATA_NAME_MAX→namelonger than 32 characters400 INVALID_DATA_IMAGE→imagelonger than 512 characters400 INVALID_DATA_DESCRIPTION_MIN→descriptionshorter than 12 characters400 INVALID_DATA_DESCRIPTION_MAX→descriptionlonger than 256 characters400 INVALID_DATA_DELIVERY→deliveryother thanDIGITALorPHYSICAL400 INVALID_DATA_PRICE→priceoutside0.5to9999400 INVALID_DATA_STOCK→stockoutside-1to9999400 INVALID_DATA_POSITION→positionless than1400 CATEGORY_NOT_FOUND→ one or more categories incategoryIdsnot found in the store400 NAME_ALREADY_EXISTS→ name already in use401 API_KEY_NOT_PROVIDED→Authorizationheader not sent (orTOKEN_NOT_PROVIDEDvia Bearer)401 INVALID_API_KEY→ invalid API Key (orINVALID_TOKEN/TOKEN_EXPIRED/SESSION_NOT_FOUND/SESSION_EXPIRED/UNAUTHENTICATEDvia Bearer)403 USER_DISABLED→ user disabled or deleted403 NO_ACTIVE_SUBSCRIPTION→ inactive or expired plan (orPENDING_2FAvia Bearer)404 STORE_NOT_FOUND→ store not found404 PRODUCT_NOT_FOUND→ product not found429 RATE_LIMIT_EXCEEDED→ rate limit per minute exceeded500 INTERNAL_SERVER_ERROR→ internal error503 SERVICE_UNAVAILABLE→ service or database unavailable
Path Parameters
Body
application/json
Product fields to update.