Download Media
AI-generatedSummary
Download an incoming media file by providing its message ID, retrying if the file is not yet ready on the server, and store the downloaded file in a specified binary property.
Inputs
- Message ID (required) — Incoming message ID that has a file (usually obtained from a Trigger node).
- API Key Override — Override the default API key per item; leave empty to use the credential's API key.
- Put Output In Field — Binary property name to store the downloaded media file, default is 'data'.
- Max Retries — Number of retry attempts if the media file is not yet ready on the server (when receiving a 404 “media not ready” response), default is 6.
Output shape
a list of items each containing the downloaded media file as binary data under the specified binary property, along with JSON metadata including message_id, mime_type, and file_name.
If the media file is not immediately available, the node will retry up to the Max Retries count. On other errors such as unauthorized access or message not found, the node fails immediately. The output pairs each media download result with the input item.
Examples
Example 1: Downloading an incoming media file
Set 'Message ID' to the inbound message ID with media, optionally override API key, specify the binary property to store the file, and set max retries for waiting if the file is processing.