File Share

Active

Your agent has nowhere to host a file; this returns a gated, shareable download link.

2 tools

Host a file and get a gated public download link with optional password, one-time access, and expiry. The link is safe to hand to anyone; the bytes are stored privately and force-downloaded.

Sharingfilessharingdownloadstoragelinks

Tools (2)

▶share

Host a file privately and return a gated public download link (password / one-time / expiry optional).

Usage-based · 1 credit per share, plus 0.003 credits per MB per day of storage

Example prompts

“Share this report as a download link that expires in 24 hours”
“Give me a password-protected, one-time link to this file”

Parameters

filenamestringoptional

Download filename. Inferred from source_url when omitted.

one_timebooleanoptionaldefault: false

Delete the file after the first successful download.

passwordstringoptional

If set, downloading requires this password.

ttl_hoursintegeroptionaldefault: 24

How long the link stays live (max 30 days).

source_urlstringoptional

Presigned GET URL of the file to host (e.g. another tool's output or an /uploads/presign get_url).

content_typestringoptional

MIME type. Sniffed when omitted.

content_base64stringoptional

Inline file contents, base64. Use for small files instead of source_url. Max 256 KB decoded.

API Usage

curl -X POST "https://skill.askfaro.com/skills/files/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Share this report as a download link that expires in 24 hours"
  }
}'

CLI Usage

askfaro describe files/files.share

Install pip install askfaro-cli, then askfaro auth login.

manage

▶revoke

Revoke a file share by id: deletes the stored file and disables the link. Free.

Free

Example prompts

“Revoke the file share I created earlier”

Parameters

idstringrequired

The share id returned by share.

API Usage

curl -X POST "https://skill.askfaro.com/skills/files/run" \
  -H "Authorization: Bearer faro_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{
  "intent": {
    "prompt": "Revoke the file share I created earlier"
  }
}'

CLI Usage

askfaro describe files/files.revoke

Install pip install askfaro-cli, then askfaro auth login.