Categories
Reorder Categories
Learn how to reorder store categories using the endpoint PUT /stores//categories/reorder.
PUT
Reorder categories
📌 Endpoint
PUT /stores/{storeId}/categories/reorder
Reorders the store categories according to the sequence sent in categoryIds.
🔐 Authentication
- Private route.
- Send
Authorizationwith your API Key.
🧾 Route parameters
🧍 Body
✅ Example request
📦 Success response (200)
⚠️ Possible errors
400 INVALID_DATA→ invalid payload, empty array, duplicate IDs, or elements that are not valid UUIDs400 CATEGORY_LIST_INVALID→ one or more IDs do not belong to the store401 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)403 STORE_NOT_FOUND→ store not found or no permission429 RATE_LIMIT_EXCEEDED→ rate limit per minute exceeded500 INTERNAL_SERVER_ERROR→ internal error503 SERVICE_UNAVAILABLE→ service or database unavailable
📝 Notes
- The endpoint
GET /stores/{storeId}/categoriesreturns the categories ordered byposition. - The frontend must send the complete list of IDs in the final order to ensure consistency.