Skip to content

Move a node

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

Moves a node, with everything beneath it, under newParentNodeId. It is added at the end of the new parent’s children; follow with PUT /experience/nodes/reorder to put it somewhere else. A site root cannot be moved.

The key’s role needs edit on the node and on its new parent. Send rowVersion from your last read to refuse the move if the node changed since. The page’s published address changes only when it is republished.

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

id
required
string format: uuid
Media typeapplication/json
object
newParentNodeId
required
string format: uuid
rowVersion
null | integer | string format: uint32
/^-?(?:0|[1-9]\d*)$/
Examplegenerated
{
"newParentNodeId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
"rowVersion": 1
}

OK

invalid_move: the node is a site root, or the new parent is the node itself or one of its descendants.

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 node or the new parent.

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.

No node has this id or newParentNodeId, or the key’s role cannot see it.

duplicate_slug: a child of the new parent already resolves to this node’s slug; localeSlot and conflictingNodeId say where. concurrency_conflict: the node changed since rowVersion; re-read it and retry.

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