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.

Purpose

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.

Required ability

project-recovery:create

Input schema

{
    "type": "object",
    "required": [
        "resource_id"
    ],
    "properties": {
        "resource_id": {
            "type": "string",
            "description": "UUID of the resource to swap onto its standby."
        }
    }
}

Output shape

{
    "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": {}
}

Example prompts

"Move Signals onto its standby channel now."

Failure modes

VALIDATION_FAILED — no healthy standby, the channel recovery allowance is spent with no recovery to join, or the token is not the project owner's.
RESOURCE_NOT_FOUND — resource_id is not a resource the token can see.
AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks project-recovery:create.

revert_recovery_operation — put the old chat back.
get_recovery_roll_call — how re-admission is going.
Recovery API