Download media

• Type media.download
• Group MZBase
• Role action
• Risk reads only
• Side effect safe to repeat
• Runs once per item
• Needs media, network

Downloads a file from a direct URL

Also available to AI agents and over MCP as a tool.

Parameters

url

URL · string · required

Address of the file to download.

maxSizeMb

Max size (MB) · integer · optional · default 500 · range 1 – 10240

Larger files fail instead of filling the disk.

timeoutMs

Timeout (ms) · integer · optional · default 300000 · range 1000 – 3600000

How long to wait, in milliseconds, before the step fails.

useProfileProxy

Use the profile’s proxy · boolean · optional · default false

Download through the run’s profile proxy.

fileName

File name · string · optional

into

Into field · string · optional · default data

saveTo

Save to · string · optional · default none · one of none, media

Where the result goes: back on the item as a file, or into the media library (the item then gets mediaId).

mediaFolder

Media folder · string · optional

Shown when saveTo is media.

mediaTags

Media tags · array · optional

Shown when saveTo is media.

Outputs

• main

← All nodes