Public Sharing (experimental)
Theshare_with_public tool provides authenticated link sharing for workspace files (unlisted links). This is an experimental feature that must be enabled per-workspace at /keys.
Important: Recipients must be signed in to Undisk. These are not anonymously public URLs.
How it works
- Enable the experiment toggle in your workspace settings at
/keys - Use
share_with_publicwithaction: "create"to generate a share link - Anyone with an Undisk account who has the link can view the file content
- Shares always serve the latest file version
- Revoke any share at any time with
action: "revoke"
Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
action | "create" | "revoke" | "list" | yes | Operation to perform |
path | string | for create/revoke | File path to share or revoke |
Example: share a file
Security and behavior
- Authentication required: viewers must have an Undisk account — links are not truly “public”
- No metadata exposed: shared content pages show only file content, no paths, workspace info, or owner details
- Not indexed: all share pages include
noindex, nofollowandX-Robots-Tag: noindexheaders - Content moderation: files flagged by content moderation cannot be shared; existing shares become inaccessible if the file is later flagged
- Limit: up to 100 active shares per workspace
- Shares follow moves: if you move a shared file, the share link continues to work
- Immediate revocation: revoking a share takes effect instantly; the share ID cannot be reused
- Cloudflare only: this feature is currently available on the Cloudflare provider only