Share Links
Share Links#
Share links let you expose a single todo set to people outside your team — clients, collaborators, or the public — without giving them a Prism account or team membership. Each link is a unguessable URL with its own set of capabilities, so you can publish a read-only roadmap or open up a collaborative checklist as needed.
Share links also generate embeddable SVG images (a progress badge and a rendered checklist) that you can drop into a README, wiki, or dashboard.
Creating a Share Link#
Open the set you want to share.
Open Manage Links (from the set’s ... menu).
Click New link, give it a name, and choose its capabilities.
Copy the generated URL and share it.
Creating, editing, and deleting links requires the manage_set_links permission (granted to owners, co-owners, and admins by default).
Capabilities#
Each link grants a precise set of capabilities. By default a new link is view-only.
| View | Read the set and its todos (default on). |
| Create | Add new todos and sub-todos. |
| Edit | Change todo titles. |
| Complete | Toggle todo completion. |
| Delete | Delete todos. |
| Comment | Reserved for future public commenting. |
| Reorder | Drag to reorder todos. |
Visitors only see and can perform the actions the link allows; everything else is blocked server-side.
Anyone who has the link URL can use it within its granted capabilities. Treat write-enabled links like a password and delete them when no longer needed — deleting a link instantly revokes access.
Restricting by Email#
A link can be limited to specific people with a comma-separated email allow-list. When set:
Visitors are prompted to enter their email before the set loads.
Only emails on the list are granted access; everyone else is denied.
Leave the allow-list empty for a fully public link.
The email check is a lightweight gate, not authenticated identity verification — there is no email confirmation step. Use it to keep casual links private, not to protect highly sensitive data.
Embeddable Badges & Checklists#
Every link can render two cached, read-only SVG images. These ignore capability flags and email restrictions, so they always render for anyone with the token.
Progress badge#
A shields.io-style badge showing completed/total:
Customize it with query parameters such as style=flat-square, label=Roadmap, or color=blue.
Checklist image#
A full rendered checklist of the set:
Useful options: theme=dark, maxItems=10, width=480, showProgress=false, plus color overrides. See the Share Links API for the full parameter list.
Managing Links#
From Manage Links you can:
See every link for the set, including its capabilities and creation date.
Edit a link’s name, capabilities, or email allow-list at any time.
Delete a link to immediately revoke it.
A team-wide view lists all links across every set (annotated with the set name) for auditing.
API Reference#
See the Share Links API for the full endpoint reference, request/response shapes, and error codes.