WolfSuite Workspace · Documentation

# Share a document by link

A member can share one document by link. Anyone with the link can see the document without an account and without taking a seat, and the member can end the link at any time. [1](#evidence-1) [2](#evidence-2)

## Make a link

Only a person who is a member of the room can make, read or end a share link, and only for a document that exists. Agents and guests are refused. [3](#evidence-3) [4](#evidence-4)

A document has one link at a time. Sharing it again returns the same link. The token is 32 random bytes in base64url. [5](#evidence-5) [1](#evidence-1)

A link can be given an expiry when it is made, and the expiry can be cleared later without changing the link. An expiry outside the allowed range is refused. [6](#evidence-6)

## What someone with the link sees

- The document's name, format and revision, and the name of the member who shared it, with no sign-in and no seat taken. [2](#evidence-2)
- The rendered pages of the current revision. A browser that already holds them is answered `304 Not Modified`. [7](#evidence-7)

The hosted service answers the share route without asking for sign-in: on November 20, 2026, an unknown token on a production workspace returned `404 SHARE_NOT_FOUND` with no redirect. A read with a valid link has not been observed on the hosted service; the behavior above is covered by tests. [8](#evidence-8)

## End a link

Ending a link is permanent. The old link answers `404 SHARE_NOT_FOUND`, with the same response as a link that never existed. Sharing the document again makes a new link. [9](#evidence-9) [10](#evidence-10) [1](#evidence-1)

When public sharing is turned off for the workspace, existing links stop answering at once and new links are refused with `PUBLIC_SHARES_DISABLED`. Members can still end their links. [6](#evidence-6)

A read-only workspace cannot make new links, and links that already exist can still be ended. [11](#evidence-11)

## Share a link or invite a guest

A link shows a document. To let someone outside the team comment and propose changes, invite them as a guest instead: a guest also takes no seat, and its changes wait for a member's approval. [12](#evidence-12) [13](#evidence-13)

## Evidence

Each numbered reference above points to the test that exercises the statement or to a recorded observation of the hosted service at workspace.wolfsdk.com. Test paths are relative to the WolfSuite repository.

1. Test `sdk/web/packages/workspace-cli/test/share.test.ts`: “is made once, read, and ended”
2. Test `sdk/web/packages/workspace-cli/test/share.test.ts`: “tell anyone with the token what the document is, with no credentials and no seat”
3. Test `sdk/web/packages/workspace-cli/test/share.test.ts`: “needs a member who is a user, and a document that exists”
4. Test `sdk/web/packages/workspace-cli/test/guest.test.ts`: “is refused a room, an upload, the export, the pack and a share link, each with 403 FORBIDDEN”
5. Test `sdk/web/packages/server/test/shares.test.ts`: “is 32 random bytes in base64url, one per document, and the same one when shared again”
6. Test `sdk/web/packages/workspace-cli/test/share.test.ts`: “supports optional link expiration, rejects out-of-range expiries, and darkens links when disabled”
7. Test `sdk/web/packages/workspace-cli/test/share.test.ts`: “serve the painted pages of the head with its ETag, and 304 for a client that holds them”
8. Production observation, November 20, 2026: An unauthenticated GET of /api/share/invalid on a production tenant under workspace.wolfsdk.com returned 404 SHARE_NOT_FOUND without a sign-in redirect. Recorded in `evidence/ltg-www-wolfsdk-workspace-product-page-20261120.json`.
9. Test `sdk/web/packages/workspace-cli/test/share.test.ts`: “answer 404 SHARE_NOT_FOUND for an unknown token and for an ended one, with the same body”
10. Test `sdk/web/packages/server/test/shares.test.ts`: “ends for good with unshare, and a later share makes a new token”
11. Test `sdk/web/packages/workspace-cli/test/share.test.ts`: “can be ended, and not made, once the workspace is read-only”
12. Test `sdk/web/packages/workspace-cli/test/guest.test.ts`: “takes no seat, however it reads”
13. Test `sdk/web/packages/server/test/scoped.test.ts`: “proposes an edit to its document and comments on it, but cannot commit or decide”
