Share a file

~1 credits / share (up to 46)

Upload a file (from raw content or a source URL) and get back a download link to share. Optionally protect it with a password, make it one-time (the link expires after a single download), or set it to expire after a number of hours. Storage costs accumulate while the link stays live.

Not for

Sharing a short text snippet (use the pastebin).

Cost

~1 credits / share (up to 46)

1 credit per share, plus storage per megabyte per day the link stays live.

Estimated; the actual charge depends on your input and is shown in the response.

What it accepts

Set these inside the intent when you run it.

filenamerequired

The filename to present when the link is downloaded.

source_urloptional

A URL whose contents to share. Use this or content_base64.

content_base64optional

The file contents as a base64-encoded string. Use this or source_url.

content_typeoptional

The MIME type of the file, e.g. application/pdf.

ttl_hoursoptional

Hours until the download link expires.

one_timeoptional

If true, the link stops working after the first download.

passwordoptional

A password required to access the download link.

What you get back

A download link for the shared file, along with an ID for revoking it later.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the File Share skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/files/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"share","filename":"report.pdf","source_url":"https://example.com/report.pdf","content_base64":"JVBERi0xLjQKJ...","content_type":"application/pdf","ttl_hours":24,"one_time":true,"password":"secret123"}}'

Example requests

›Share this PDF and give me a download link.
›Upload this file and make a one-time link that expires in 24 hours.
›Create a download link for the file at this URL.

← Back to File Share