notify_members_of_recovery
Email every member the project can reach that its bot changed after a bot replacement, at the per-email fee. Sent once per recovery.
After a bot replacement, members who only ever talked to the old bot need the new one's link. This emails every member the project can reach by email with the new bot and the portal, at the per-email fee added to the creator's transaction fees, and remembers that it did: a second call answers with the count already sent and sends nothing. It spends money and reaches real people, so confirm with the creator first.
This tool is annotated destructive: a client that supports the annotation asks a human before running it. The REST twin is POST /v1/recovery/operations/{operation}/notify-members.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
A client that honours annotations asks a person before running it.
Arguments
operation_id*stringUUID of the bot recovery whose project members to email.
What it returns
{ "data": { "operation_id": "c2e8f1a9-6d47-4b3e-9f05-1a8d7c2e4b60", "notified": 340 }, "meta": {}}How it fails
VALIDATION_FAILEDthe recovery belongs to no project, or the token is not the project owner's.
RESOURCE_NOT_FOUNDoperation_id is not in this creator's ledger.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-recovery:update.
How is this guide?
Last updated on
list_recovery_operations
List every Disaster Recovery operation of the creator the token acts for — by the creator, the platform or on demand — with its state and whether it can still be undone.
nudge_pending_readmissions
Send one reminder, with a fresh link, to every member a channel recovery re-admitted who has not joined the new chat yet.