Skip to content

Product Images — Reorder ​

Reorders the existing images of a product.

Endpoint ​

EndpointMethod
/api/admin/catalog/products/{productId}/images/reorderPUT

Request body ​

FieldTypeRequiredNotes
orderarray of { id, position }yesEach id must belong to {productId}.

Response ​

200 OK — returns the full updated list of images, ordered by position.

FieldTypeNotes
successbool
messagestring
imagesarrayOne row per image — id, productId, path, position, url.

Errors ​

HTTPCause
401 UnauthorizedMissing or invalid admin Bearer token.
403 ForbiddenAdmin role lacks catalog.products.edit.
422 Unprocessable EntityImage ID doesn't belong to the product, or order is malformed.

Released under the MIT License.