Skip to content

Reorder sibling nodes

PUT
/content/management/v1/experience/nodes/reorder
curl --request PUT \
--url https://api.ebitex.io/content/management/v1/experience/nodes/reorder \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "parentNodeId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "orderedNodeIds": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ] }'

Sets the order of one parent’s children. Send parentNodeId and orderedNodeIds, which must list every current child of that parent exactly once, in the order you want. A null parentNodeId orders the environment’s sites instead.

A list that is missing a child or names one that is not there is refused: someone else has changed the tree, so list the children again and retry. The key’s role needs edit on the parent, or on every site when ordering sites.

Order reaches delivery navigation when the reordered pages are republished.

Key: a management key with content.management.authoring.

Media typeapplication/json
object
parentNodeId
required
null | string format: uuid
orderedNodeIds
required
Array<string>
Examplegenerated
{
"parentNodeId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"orderedNodeIds": [
"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
]
}

The reordered children, in their new order, in the shape GET /experience/nodes/{id}/children returns.

incomplete_sibling_set: orderedNodeIds does not match the parent’s current children; re-read them with GET /experience/nodes/{id}/children and retry.

missing_api_key or invalid_api_key: no key was sent, or it is unknown, revoked or expired.

payment_required: the organization’s subscription needs attention.

access_denied: the key’s role may not edit the parent, or one of the sites.

scope_denied: the key lacks this route’s scope. tier_required: the Content Management API needs the Pro plan or above. ip_denied: the caller’s address is outside the key’s allowed ranges. app_not_available: Content is not enabled for the organization.

The parent, or one of the sites, does not exist or the key’s role cannot see it.

Rate limit or quota exceeded; Retry-After says how long to wait. too_many_failed_authentications: too many bad keys from this address.