Skip to content

Reorder the featured list

PUT
/admin/featured/order

Replaces the ordering with the supplied id sequence — each id is assigned its 0-based array index as its new position, in one transaction. Ids not present in the list are left untouched. Requires system.admin.

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