Skip to content

ListNodesOptions

GET /nodes. Every option is optional: with none of them, the request is the whole tree of the site the request Host maps to.

optional from?: string

The anchor: a node Guid or a published path (/blog/second). Defaults to the site root.


optional host?: string

The hostname a localeHost site serves, for a path-shaped from — see PathOptions.host.


optional include?: readonly NavigationInclude[]

Defaults to ['self', 'descendants'] server-side — a bare call is the whole site tree.


optional locale?: string

Refused when from is a path under a site with a locale addressing strategy (400 locale_not_addressable) — the path’s own prefix or host says the locale.


optional maxDepth?: number

Bounds descendants by absolute depth from the site root — the same scale NavigationNode.depth reports.


optional signal?: AbortSignal

RequestOptions.signal


optional site?: string

Site root node id, from listSites. Omitted, the server infers it from the request Host.