get

Retrieve an asset (file or folder) by id.

get

Retrieve an asset (file or folder) by id.

Retrieve a single asset by id. assetType == 1 means it is a folder.

Safety class: A · API type: admin · Min version:

📘

Confinement

Read-only; safe anywhere.

Signatures

def get(sdk, asset_id):
    """Return the asset dict for asset_id, or None if it does not resolve."""
    return sdk.get_asset(asset_id)
export async function get(sdk, assetId) {
    // Return the asset object for assetId (or null if it does not resolve).
    return await sdk.getAsset(assetId);
}

Parameters

Parameter (Python)Parameter (JS)TypeRequiredNotes
sdksdkNomad_SDKyesauthenticated client
asset_idassetIdstryese.g. <asset-uuid>

Returns

dict | None — asset dict (id, parentId, displayName, assetType); None if not found

Errors

  • 401 unauthenticated
  • 404 not found -> returns None

See also: Python ↔ JS naming map · Return shapes.