Skip to main content
PUT
Reorder products

📌 Endpoint

PUT /stores/{storeId}/products/reorder Reorders the store’s products according to the sequence sent in productIds.

🔐 Authentication

  • Private route.
  • Send Authorization with 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 UUIDs
  • 400 PRODUCT_LIST_INVALID → one or more IDs do not belong to the store
  • 401 API_KEY_NOT_PROVIDED → Authorization header not sent (or TOKEN_NOT_PROVIDED via Bearer)
  • 401 INVALID_API_KEY → invalid API Key (or INVALID_TOKEN / TOKEN_EXPIRED / SESSION_NOT_FOUND / SESSION_EXPIRED / UNAUTHENTICATED via Bearer)
  • 403 USER_DISABLED → user disabled or deleted
  • 403 NO_ACTIVE_SUBSCRIPTION → inactive or expired plan (or PENDING_2FA via Bearer)
  • 404 STORE_NOT_FOUND → store not found or no permission
  • 429 RATE_LIMIT_EXCEEDED → rate limit per minute exceeded
  • 500 INTERNAL_SERVER_ERROR → internal error
  • 503 SERVICE_UNAVAILABLE → service or database unavailable

📝 Notes

  • The endpoint GET /stores/{storeId}/products returns products ordered by position.
  • The frontend must send the full list of IDs in final order to ensure consistency.

Authorizations

Authorization
string
header
default:YOUR_API_KEY_HERE
required

Path Parameters

storeId
string
required
Required string length: 1 - 50

Body

application/json

Ordered product IDs.

productIds
string<uuid>[]
required
Minimum array length: 1

Response

Positions updated in provided order.

code
string
required
Example:

"PRODUCTS_REORDERED"