well_list_share_links

io.github.WellApp-ai/well-mcp · Verify this server

List the workspace's shared links that still open: each link a member made with well_share_widget or well_share_canvas, newest first. Each row says what is shared (the board's name, and the widget's tool for a one-widget link), who made it (`created_by`), when it was made and when its last snapshot was taken. A link opens until it is stopped, so its `expires_at` is null; only a row of `kind: "widget"` carries a date. A member sees the links they made; a workspace owner or admin sees every link of the workspace. `can_stop` says whether the person may stop or refresh that link: they made it, or they are a workspace owner or admin. Call it when the person asks what has been shared, which links are still open, for a link they made and lost, or to stop or refresh a link they cannot name exactly. Pass `canvas_view_id` to list only the links of one board. `url` is the link itself, set only on the person's own links: give it back rather than making a new link. A colleague's link has no `url`; it is theirs to send. Use the `share_link_id` of a row with well_refresh_share_link or well_revoke_share_links. When `next_cursor` is set, more links follow: pass it as `cursor` to read the next page. When the token authorizes one workspace, call this directly — no workspace call is needed first. When it authorizes several, this read will not guess which one you mean: pass `workspace_id` on the call.