# File Share

> Skill `files` on Faro. 2 sub-skills.

Share any file at a temporary download link. Provide the file contents or a source URL and get back a link you can send to anyone. Links support optional expiry, one-time access, and password protection. Revoke a link at any time to stop access immediately.

**Category:** Sharing  
**Tags:** files, sharing, download, storage, links  
**Use when:** You need a temporary download link for a file or a URL's contents.  
**Not for:** A short text snippet (use the pastebin) or a small value by key (use the key-value store).  
**Returns:** information

## How to run
Skills run through one gateway with your Faro token. Hand it an `intent` in plain language; Faro routes to the right sub-skill, runs it, and bills per call. Raw tools are internal plumbing and are not directly callable.

```
POST https://skill.askfaro.com/skills/files/run
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"intent":{"prompt":"Share this PDF and give me a download link."}}
```

Or from the CLI:

```bash
pip install askfaro-cli && askfaro auth login
askfaro run files "Share this PDF and give me a download link."
```

Full run reference: https://askfaro.com/llms/run.md — Agent recipe: https://askfaro.com/llms/skill.md

## Example requests

- Share this PDF and give me a download link.
- Revoke the file link I just created.

## Sub-skills

### Share a file

Shares a file at a download link and returns the link.

**Cost:** ~1 credits / share (up to 46) — 1 credit per share, plus storage per megabyte per day the link stays live.

**Details:** https://askfaro.com/llms/skills/files/share.md

---

### Revoke a file

Revokes a previously shared file.

**Cost:** Free

**Details:** https://askfaro.com/llms/skills/files/revoke.md

---

---
On the web: https://askfaro.com/search/files