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.