Skip to content

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.

object
ids
required
Array<string>

Reordered.

Malformed request

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed