create_placeholder

Create a placeholder (content-less) asset under a folder; return its id.

create_placeholder

Create a placeholder (content-less) asset under a folder; return its id.

Create a placeholder asset (the name must include an extension).

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

📘

Confinement

parent_id must be your run-root anchor or a folder beneath it.

Signatures

def create_placeholder(sdk, parent_id, asset_name):
    """Create a placeholder asset under parent_id; return its id."""
    result = sdk.create_placeholder_asset(parent_id, asset_name)
    return result["id"]
export async function createPlaceholder(sdk, parentId, assetName) {
    // assetName MUST include a file extension.
    const result = await sdk.createPlaceholderAsset(parentId, assetName);
    return result.id;
}

Parameters

Parameter (Python)Parameter (JS)TypeRequiredNotes
sdksdkNomad_SDKyes
parent_idparentIdstryese.g. <folder-uuid>
asset_nameassetNamestryesMUST include a file extension

Returns

str - the new placeholder asset's id (from create_placeholder_asset -> {id})

Errors

  • 401 unauthenticated
  • 404 parent not found

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


Did this page help you?