# Share Links Share Links are private, per-file URLs — anyone with the link can view the file without an account, and nothing about it ever appears in the community. ## How share links work Every share link lives at a secret URL: ``` https://www.monofile.ai/l/ ``` - **The URL is the access control.** Only people you give it to can find it — links are excluded from search engines and never listed anywhere. - **Zero community surface.** A linked file doesn't show up in the feed, can't be voted on or commented, and isn't included in community search. - **One link per file.** Creating a link for a file that already has one updates the existing link rather than making a second. - **Files only.** Share links are for individual files. To publish a whole folder, use [[Community]] sharing instead — that's a separate, public system. ## In the app Open a file and choose **Share** from the tab actions menu, or right-click the file in the file tree. The share dialog gives you: - **Copy link** — grab the URL and send it to anyone. - **Expiry** — optionally make the link stop working after a set time. - **Shared version** — by default, viewers always see the latest saved content. Pin (freeze) the current version and viewers keep seeing exactly that content while you continue editing. Unpin any time to go back to live. - **Password** — require a password before the content is shown. Changing or removing the password signs out everyone who had previously unlocked the link. - **Revoke** — permanently disable the link. Revocation is immediate and irreversible: creating a new link later generates a completely different URL, so the old one can never come back to life. Viewers get a clean, read-only page with just the file's content — no editor chrome, no sign-in prompt. ## For agents The same capabilities are available through the agent tools API: `create_share_link` creates or updates a file's link (with the same expiry, freeze, and password options), `get_share_link` reports whether a link exists along with its URL, view count, expiry, and pin state, and `revoke_share_link` permanently disables it. See [[Tools API]] for the full reference. ## Good to know - Each link tracks a view count, so you can tell whether anyone has opened it. - A frozen link stores a copy of the pinned content — later edits never change what viewers see until you unpin. - Treat the URL like a secret. Anyone who has it can view the file until the link expires or you revoke it.