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)TypeRequiredNotes
sdksdkNomad_SDKyes
asset_idassetIdstryese.g. <asset-uuid>
page_sizepageSizeintnoe.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.