> ## Documentation Index
> Fetch the complete documentation index at: https://help.plannotator.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Copy a Raw File Link from Workspaces

> Copy the saved bytes of a workspace document and understand living and version-pinned raw links.

**Copy raw link** copies a living raw URL, not the collaborative app link. It
serves the latest saved bytes of the workspace's primary document. If no
primary document is set, it serves the first document by path.

Only the workspace owner can open the **Share** dialog and use this action.

## 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**

Living raw links do not use sign-in, organization membership, or guest links.
They cannot serve a workspace set to **Only you** or **Your organization**.

## Copy the raw link

1. Wait for the document to reach a save point.
2. Select **Share**.
3. If needed, choose one of the two settings above and select **Save**.
4. Open **Share** again.
5. Select **Copy raw link**.
6. Test the link in a signed-out browser before sending it.

The response contains the file bytes. Markdown stays Markdown source. HTML
stays HTML source. Workspaces does not turn either file into an app page.

Raw-file requests do not extend an anonymous workspace's 30-day expiry. Use
the share in the app or through an authenticated API or MCP request to record
activity. You can also claim the workspace before the date shown to remove the
expiry.

If Workspaces shows **Couldn't copy the raw link.**, do not use **Copy link**
instead. The two actions copy different URLs. Retry the clipboard action. An
owner with an API key can also read the workspace's `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:

1. The workspace's primary document, when one is set.
2. The first document in path order when no primary document is set.

The link serves that document's latest save point. Live edits that have not
reached a save point do not appear yet. A browser or proxy may show the prior
save point for up to 60 seconds.

For a specific document or artifact, use the `urls.raw` value from
`GET /v1/workspaces/{wsId}/artifacts`. The URL includes that file's path. See
[Use the Workspaces API](/workspaces/agents/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

| Result                                                     | Cause and recovery                                                                                                                                                                                                                                                                |
| ---------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A living link returns `404`                                | The workspace uses **Only you** or **Your organization**, the file has no save point, the path is wrong, someone deleted the current path or workspace, the workspace is empty, or cleanup removed it after expiry. Check the workspace setting, path, expiry, and saved version. |
| A frozen link returns `404`                                | The workspace no longer exists, or that exact path and version was never stored or is no longer available. Check the full URL.                                                                                                                                                    |
| A living link opens the app on the default container setup | The workspace is set to **Only you** or **Your organization**. Change the setting only if you intend to give raw public access. Otherwise, use the collaborative app while signed in.                                                                                             |
| A raw link opens the app on a Cloudflare deployment        | The request reached the app Worker instead of the usercontent Worker. Do not change workspace access. Ask the operator to fix the usercontent Worker route or domain and the app Worker's `USERCONTENT_ORIGIN`.                                                                   |
| The link serves the wrong document                         | **Copy raw link** targets the primary document or first path, not the open document. Use that document's raw URL from the API.                                                                                                                                                    |
| A recent edit is missing                                   | Wait for a save point, allow up to 60 seconds for cached content, then reload.                                                                                                                                                                                                    |
| A frozen link still works after access changed             | Version-pinned raw URLs are credentials for stored versions. Delete the workspace to make its frozen URLs unreachable.                                                                                                                                                            |

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](/workspaces/security/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](/workspaces/sharing/share-a-workspace) covers that path.

*Reviewed July 22, 2026. Maintained by the Plannotator documentation team.*
