recovery.resource_replaced

The creator pointed a resource at a replacement channel or group — in a recovery after a ban, or on demand for a healthy resource.

When this fires

The creator swaps a resource onto another chat: a replacement channel after a ban, the standby in one click, or a healthy resource moved to a new supergroup on demand (Swap & Grant, which spends no allowance). The resource is re-pointed, the old links revoked and every active member's re-admission queued. One event per resource swapped, each under the operation_id of the recovery absorbing it.

Required ability

project-recovery:view — token must carry this at mint time to subscribe an endpoint to this event.

Payload

{
  "id": "evt_01HX...",
  "type": "recovery.resource_replaced",
  "created_at": "2026-06-20T18:04:11Z",
  "api_version": "2026-05-01",
  "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
  "data": {
    "operation_id": "d4b7a2c9-1e58-4f36-8a0d-6c2e9b7f1a45",
    "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
    "resource_id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",
    "resource_title": "Members",
    "connector": "telegram",
    "replaced_at": "2026-06-20T18:04:11Z",
    "on_demand": true
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `recovery.resource_replaced` for this event.
`created_at`	ISO 8601 timestamp	Server-side emission time.
`api_version`	string	Webhook API contract version.
`project_id`	string UUID	Project this event belongs to.
`data.operation_id`	string UUID	The recovery the swap ran under; several swaps inside the grace period share one.
`data.project_id`	string UUID	The project.
`data.resource_id`	string UUID	The resource, now pointing at the replacement.
`data.resource_title`	string \| null	The resource's title, as plans show it.
`data.connector`	string \| null	The connector the chats live on.
`data.replaced_at`	ISO 8601 timestamp	When the resource was re-pointed.
`data.on_demand`	boolean	True for a Swap & Grant of a healthy resource with no open incident, which spends no allowance.

Caveats

A swap onto the standby chat also fires recovery.standby_removed with reason: used.
project.resource.updated fires for the same resource with changes.space_id, as it does for any swap.

recovery.resource_failed_over — the same swap made by the platform.
recovery.operation_reverted — the swap put back inside the window.
Recovery events overview — back to family overview.