use_resource_standby
Swap a resource onto its standby right now: old links revoked, every active member re-admitted, the standby consumed. Returns the recovery operation it ran under.
The one-click swap from the Prevention page. The resource points at the standby chat, the old invite links are revoked and every active member is re-admitted into the standby; the standby is consumed. A recovery operation records it: for a healthy resource with no open incident the swap is on demand and spends no allowance, otherwise it spends (or joins) the channel recovery allowance. Undo is offered for 24 hours through revert_recovery_operation. Only the project owner may do this.
This tool is annotated destructive: a client that supports the annotation asks a human before running it. The REST twin is POST /v1/projects/{project}/resources/{resource}/standby/use.
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.
Fires events
Delivered to every endpoint subscribed to it once the change is made.
Annotations
A client that honours annotations asks a person before running it.
Arguments
resource_id*stringUUID of the resource to swap onto its standby.
What it returns
{ "data": { "id": "9a4d2e71-5b38-4c6f-8e12-3d7c9b0a5f21", "kind": "resources", "kind_label": "Channels and Groups", "status": "completed", "status_label": "Completed", "connector": "telegram", "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13", "project_name": "Research Premium", "grant_id": null, "automatic": false, "on_demand": true, "failure_reason": null, "started_at": "2026-09-12T10:00:00Z", "completed_at": "2026-09-12T10:00:31Z", "reverted_at": null, "revertible": true, "revert_window_ends_at": "2026-09-13T10:00:31Z" }, "meta": {}}How it fails
VALIDATION_FAILEDno healthy standby, the channel recovery allowance is spent with no recovery to join, or the token is not the project owner's.
RESOURCE_NOT_FOUNDresource_id is not a resource the token can see.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-recovery:create.
How is this guide?
Last updated on
update_recovery_settings
Change one project's Disaster Recovery settings: switch automatic failover on or off (with the fee consent), and choose how members are told after a swap. Fields left out keep their value.
withdraw_resource_replacement_request
Take back the replacement request the creator has open on the connector. Takes no input.