Skip to main content
Browse Documentation
HTTP - Delivery

Get ancestor nodes

Created by Contensis product team, last updated 22 Jun 2020

Gets the ancestor nodes for a node as a list, returned in depth ascending order.

GET/api/delivery/projects/{projectId}/nodes/{nodeId}/ancestors

Parameters

NameParameter typeTypeFormatDescriptionExampleRequired
projectIdpathstringThe project identifier found in the project overview screen of the management consolemovieDbtrue
nodeIdpathstringuuidThe node identifier as a 128 bit GUIDtrue
languagequerystringlanguageThe specified language for the node. If no value is provided then the project primary language is usedfalse
startLevelquerynumberintegerThe level of the top ancestor node to return. If no value is provided then the level will be 1 (root)false
versionStatusquerystringThe status of the associated entry, either published or latest. The default is publishedfalse
entryFieldsquerystringA comma separated list of entry fields to include in the entry response. Specify * to include all entry fieldsfalse
entryLinkDepthquerynumberThe depth at which to resolve the full entry data for a linked entry or asset, with a maximum depth value of 10false

Example

GET: /api/delivery/projects/movieDb/nodes/d014533c-2f4e-4f73-b9f5-ff107755080b/ancestors?language=en-GB&depth=1&versionStatus=latest

Remarks

The nodes will be returned in level order ascending, i.e. root -> leaf. If the node is the root, then an empty list will be returned.

Responses

HTTP status codeReasonModel
200SuccessNode [...]
404Project not foundError
404Node not foundError
500Internal server errorError