delete

Permanently delete an asset by id.

Permanently delete an asset. This cannot be undone — guard with a within-anchor check first.

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

📘

Confinement

Only delete ids proven to be within your run-root anchor. Never delete a parent or sibling.

Signatures

def delete(sdk, asset_id):
    """Permanently delete asset_id. Returns the confirmation response (or None)."""
    return sdk.delete_asset(asset_id)

export async function del(sdk, assetId) {
    // Permanently delete assetId (cannot be undone). `delete` is reserved, so this is `del`.
    return await sdk.deleteAsset(assetId);
}

Parameters

Returns

dict | None — confirmation response on success; None on failure

Errors

• 401 unauthenticated
• 404 not found

Notes

Deleting a folder cascades to its descendants. Confirm by checking get(sdk, asset_id) no longer resolves.

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