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)
- Sign in and open the file in the dashboard.
- Choose Share and create a link.
- 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:
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.