# Share a file with a link

There are three ways to give someone a file:

| Link | Lasts | Who can create it |
|---|---|---|
| Public URL (upload with `X-Access: public`) | Until the file is deleted | API, SDK, MCP or dashboard |
| Signed URL from `GET /api/v1/files/<path>` for a private file | One hour | API, SDK, MCP |
| Share link `https://strovio.xyz/share/<token>` | Until revoked, or until the file is trashed or deleted | Dashboard only |

## Create a share link (person, in the dashboard)

1. Sign in and open the file in the dashboard.
2. Choose Share and create a link.
3. Copy the `https://strovio.xyz/share/<token>` URL.

Share links cannot be created with an API key today. An agent can create a public URL or a one-hour signed URL instead.

The trial allows 10 share links; Pro and Team are unlimited.

## Download a shared file (anyone)

A request whose `Accept` header includes `text/html` (a browser) gets a page with a download button. Any other request, such as curl, `fetch` or `Invoke-WebRequest`, is redirected to a signed download URL for the file. From a terminal:

```bash
curl -fL -OJ "https://strovio.xyz/share/<token>"
```

`-f` stops curl saving an error message as the file; `-OJ` saves it under its original name.

On Windows PowerShell use `curl.exe` with the same arguments. Adding `?download=1` to the link forces a download in a browser too.

## Common errors

- `404` "Link not found or has been revoked.": ask the owner for a new link.
- `410` "The owner moved this file to their trash." or "The file behind this link no longer exists.": the owner must restore or upload the file again.
- `502` "Storage is not responding right now.": try again in a minute.

## Revoke a share link

The owner revokes it from the file's Share panel in the dashboard. Deleting the file also removes its share links.

---

Source: https://strovio.xyz/docs/share-links
All docs for agents: https://strovio.xyz/llms.txt