Skip to main content

Get Library Download URLs

Controlled node

Overview

The Get Library Download URLs node generates temporary, signed download URLs for files stored in your project's library. These URLs can be used to share documents directly with external users or systems, or to provide temporary access to library files without requiring authentication through the Intellectible platform.

The node accepts one or more file references from the library and returns an array of temporary download URLs. Each URL is signed and valid for a limited time, allowing secure direct access to the file content.

Inputs

InputTypeDescriptionDefault
RunEventTriggers the node to generate download URLs for the specified files.-
FilesFileSourceOne or more files from the library to generate download URLs for. Accepts a single file object or an array of file objects.-

Outputs

OutputTypeDescription
DoneEventFires when the node has finished processing all files and generating URLs.
Download URLsDataAn array of temporary signed URLs for downloading the specified files. Each URL provides direct access to the file content.

Runtime Behavior and Defaults

  • File Validation: The node verifies that each specified file exists in the library storage before generating a URL. If a file is not found, it is skipped without throwing an error.
  • Extension Detection: The node attempts to determine the file extension from the filename first, then falls back to the MIME type if the initial extension check fails.
  • Temporary URLs: Generated URLs are signed and temporary, intended for short-term access or sharing. They are not permanent links to the files.
  • Batch Processing: The node can handle multiple files in a single execution, returning an array of URLs corresponding to the input files.
  • Error Handling: If no files are provided or the project ID cannot be determined, the node returns an error object in the output instead of a URL array.

Example Usage

Basic Single File Download

Connect a Get Library Files node or any node that outputs file objects to the Files input, then trigger the Run event:

[Start] → [Get Library Files] → [Get Library Download URLs] → [Show]
↓ ↓
files downloadUrls

The Download URLs output will contain a temporary URL like:

["https://storage.googleapis.com/.../signed-url?token=..."]

Multiple Files

To generate URLs for multiple files, pass an array of file objects to the Files input:

[Start] → [Find Library Files] → [Get Library Download URLs]
↓ ↓
files (array) downloadUrls (array)

The output will be an array of URLs corresponding to each input file:

[
"https://storage.googleapis.com/.../file1.pdf?token=...",
"https://storage.googleapis.com/.../file2.docx?token=..."
]

Sharing Workflow

Use this node to create shareable links that can be sent via email or used in external systems:

[Start] → [Get Library Files] → [Get Library Download URLs] → [Send Email]
↓ ↓ ↓
files downloadUrls attachments

The temporary URLs can be included in email bodies or as attachment links, allowing recipients to download files directly without needing Intellectible access.