Read a page’s element tree from the REST API
The Get Page endpoint now accepts include=elements, returning the page’s full element tree alongside the page record.
- Opt-in — omit
includeandelementsisnull.includeaccepts onlyelements(any other value returns a400). - Respects existing resolution — the returned tree honors the same
localeandversionRefparameters as the endpoint.?locale=returns the localized tree;?versionRef=ref:livereturns the published tree (default isref:draft). - Tree shape — each node has a
type, akey(a UUID unique within the tree), andprops. Nested elements live insideprops, at any depth.
include=elements is in beta and may change. Requests that pass it return 403 until the feature is enabled for your site or workspace. To opt in, contact support: support@makeswift.com.
For details, see the include parameter on Get Page.