Make the living raw link readable
A living raw link works only when the workspace uses one of these settings:- Anyone with the link can view
- Anyone with the link can view and edit
Copy the raw link
- Wait for the document to reach a save point.
- Select Share.
- If needed, choose one of the two settings above and select Save.
- Open Share again.
- Select Copy raw link.
- Test the link in a signed-out browser before sending it.
share_url through the
Workspaces API.
Know which document the link serves
The action does not use the document open in the browser. The living raw URL serves a document chosen in this order:- The workspace’s primary document, when one is set.
- The first document in path order when no primary document is set.
urls.raw value from
GET /v1/workspaces/{wsId}/artifacts. The URL includes that file’s path. See
Use the Workspaces API.
Use a version-pinned raw link
A version-pinned raw URL ends in@<version> and serves one stored file
version. GET /v1/workspaces/{wsId}/documents/{docId} returns the current
version’s URL as file_url once the document has a save point. In the artifact
viewer, each version has a Copy frozen link action.
Anyone who has the complete version-pinned raw URL can read that stored
version. Changing workspace visibility, revoking a guest link, renaming the
file, or deleting its current path does not revoke the frozen URL. Deleting the
workspace makes it unreachable. Treat the URL as a credential.
Fix common raw-link results
Raw HTML, SVG, and JavaScript can run when opened. Workspaces opens raw active
content in a sandbox, but it does not scan the file or remove unsafe code.
Review how
Workspaces handles active
content before opening an untrusted raw
link.
Use Copy link when a person needs the collaborative app, document picker,
comments, versions, or editing controls. Share a
workspace covers that path.
Reviewed July 22, 2026. Maintained by the Plannotator documentation team.
