List assets in your organization with their hierarchy details. Each asset includes its parent, its depth in the hierarchy, and how many descendants it has.
By default, the API returns one level of the hierarchy. Set include_all_descendants to true to return child assets at every level. Each asset's hierarchy_metadata lists its ancestors, from the root down.
This endpoint accepts the same filters and sorting options as List assets. Use the parent_id filter to list the immediate children of a specific asset.
The number of hierarchy levels depends on your plan. Premium allows 2 levels (a parent and its children). Enterprise allows up to 10 levels.
Requirements
If your organization uses site-based access for assets, the API only returns assets that the API token's user can access through their site membership.