get_parent_folders
Retrieve an asset's parent-folder chain (root down to immediate parent).
get_parent_folders
Retrieve an asset's parent-folder chain (root down to immediate parent).
The chain of parent folders from the root down to the asset's parent.
Safety class: A · API type: admin · Min version: —
Confinement
Read-only; safe anywhere.
Signatures
def get_parent_folders(sdk, asset_id, page_size=100):
"""Return the asset's parent-folder chain (root -> immediate parent)."""
return sdk.get_asset_parent_folders(asset_id, page_size)
export async function getParentFolders(sdk, assetId, pageSize = 100) {
// The chain of parent folders from the root down to the asset's parent.
return await sdk.getAssetParentFolders(assetId, pageSize);
}
Parameters
| Parameter (Python) | Parameter (JS) | Type | Required | Notes |
|---|---|---|---|---|
sdk | sdk | Nomad_SDK | yes | |
asset_id | assetId | str | yes | e.g. <asset-uuid> |
page_size | pageSize | int | no | e.g. 100 |
Returns
dict | None — {items:[folder summaries], totalItemCount, hasItems}, root-first. Names/parentId under item['identifiers']. None if not found.
Errors
- 401 unauthenticated
- 404 not found -> None
See also: Python ↔ JS naming map · Return shapes.
