well_revoke_document_shares

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

Stop a document download link, so it no longer opens for anyone, including in an email already sent. Call it when the user asks to stop sharing, unshare or revoke a link. `well_draft_email` puts such a link in the body of every email draft it shows (a URL ending in `/document-shares/<code>`). Pass exactly one of: - `url`: the link exactly as the user pasted it. - `invoice_id`: when the user names an invoice instead, by its id or its number (INV-2026-0148); every live link of that invoice stops. A number several invoices carry is refused with each one named: ask which. - `document_id`: when the user names another PDF that was linked. Only an owner, an admin or a member who holds the invoice right can stop a link. When the call is refused for that, tell the user who can stop it and do not retry. The document itself stays in Well. A later `well_draft_email` for the same document makes a new link, and the stopped one never opens again. Tell the user plainly that the link no longer opens. When `revoked_count` is 0, say this workspace had no live link to stop; never say a link was stopped. 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.