Reorder placements
PUT /admin/featured/order
Sets the order of placements on the rail or in the promo band: each
id in ids gets its index in the list as its new position,
starting at 0. You need system.admin.
The changes are made together. Placements you leave out keep their positions, so send every placement on the rail, or every card in the band, to get a clean order. Ids that don’t match a placement are ignored, an id listed twice takes its last position, and an empty list changes nothing.
The ids aren’t checked against one surface, so a single call can renumber rail placements and band cards together.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ”object
Responses
Section titled “ Responses ”Reordered.
Malformed request
object
Human-readable error summary
Example
the request could not be completedAuthentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}Authenticated but missing required capabilities
object
Human-readable error summary
Example
the request could not be completed