Skip to main content
PUT
Reorder stores

📌 Endpoint

PUT /stores/reorder Reorders the stores of the authenticated account according to the sequence sent in storeIds.

🔐 Authentication

  • Private route.
  • Send Authorization with your API Key.

🧍 Body


✅ Request example


📦 Success response (200)


⚠️ Possible errors

  • 400 INVALID_DATA → invalid payload
  • 400 STORE_LIST_INVALID → one or more IDs do not belong to the account
  • 401 API_KEY_NOT_PROVIDED → Authorization header not sent
  • 401 INVALID_API_KEY → invalid or not found API Key
  • 401 UNAUTHENTICATED → session/user not authenticated
  • 403 USER_DISABLED → user account disabled or deleted
  • 403 NO_ACTIVE_SUBSCRIPTION → account has no active plan
  • 429 RATE_LIMIT_EXCEEDED → plan per-minute request limit exceeded
  • 500 INTERNAL_SERVER_ERROR → internal error
  • 503 SERVICE_UNAVAILABLE → service temporarily unavailable

📝 Notes

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

Authorizations

Authorization
string
header
default:YOUR_API_KEY_HERE
required

Body

application/json
storeIds
string<uuid>[]
required
Minimum array length: 1

Response

Positions updated in provided order.

code
string
required
Example:

"STORES_REORDERED"