Skip to content
Zoan Docs

Get Storage File URL

Get Storage File URL

Section titled “Get Storage File URL”

Type: storage-get-file-url  ·  Package: Storage Activities v1.0.5  ·  Output: string

Returns a temporary link to download a file from Zoan Cloud Storage. Use it to share a file without downloading it on the robot: include it in an email, send it in a chat or hand it to another system that downloads it over HTTP.

How it works

Section titled “How it works”
  1. Identifies the file by its id or by bucket + name. If you set id, bucket and name are ignored.
  2. Zoan Cloud generates a signed link that works for 15 minutes. Anyone with the link can download the file during that time, without signing in.
  3. PDFs and images (PNG, JPEG, WebP, GIF) open in the browser; other types are downloaded with their original name.

Each call generates a new link; earlier ones stay valid until they expire. If the bucket has download auditing enabled, every generated link is recorded.

Required parameters

Section titled “Required parameters”

None. But you must set id or name; otherwise the activity fails with “Provide ‘id’ or ‘name’.”.

Optional parameters

Section titled “Optional parameters”
ParameterTypeDefaultDescription
idstring—File id (alternative to bucket + name).
namestring—File name inside the bucket, including its folders. E.g.: 2026/sales.xlsx.
bucketstring"default"Bucket name. Only used with name.

Output

Section titled “Output”

Returns a string with the temporary download link (a signed https URL, valid for 15 minutes).

Common errors

Section titled “Common errors”
MessageCause and fix
Provide 'id' or 'name'.You set neither id nor name.
… HTTP 404: …File not found in this environment.There’s no file with that reference in the robot’s environment. Check the id or the bucket + name.
Zoan Cloud did not return a URL.Zoan Cloud’s response didn’t include the link. Retry.
Storage activities require a Zoan Cloud runtime context. Missing: …The process isn’t running from Zoan Cloud or from the Designer signed in.

Errors arrive with the prefix “Could not get the file URL: ”.

Example

Section titled “Example”
Upload Storage File    path = "C:/reports/account-statement.pdf"   bucket = "customers"   → output: file
Get Storage File URL   id = file["id"]   → output: link
Log   level = info   message = "Link (valid for 15 minutes): " + link
Section titled “Related activities”