recovery.operation_reverted
The creator undid a recovery inside its window — a swapped channel put back, or the previous sign-in account restored.
When this fires
Inside the undo window the creator can put a swapped resource back onto its old chat, or move their sign-in back to the previous account. A channel recovery is undone one swap at a time, so this fires once per resource put back, with resource_id; the operation itself is marked reverted when its last standing swap is undone. An account relink is undone whole, in one event with resource_id: null, and opens an account incident (relink_disputed) so support reviews 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.operation_reverted",
"created_at": "2026-09-12T21:50:00Z",
"api_version": "2026-05-01",
"project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
"data": {
"operation_id": "9a4d2e71-5b38-4c6f-8e12-3d7c9b0a5f21",
"kind": "resources",
"connector": "telegram",
"project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
"resource_id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",
"reverted_at": "2026-09-12T21:50:00Z"
}
}Field reference
| Field | Type | Notes |
|---|---|---|
id | string ULID | Unique event id, prefixed evt_. Use for idempotent processing. |
type | string | Always recovery.operation_reverted for this event. |
created_at | ISO 8601 timestamp | Server-side emission time. |
api_version | string | Webhook API contract version. |
project_id | string UUID | null | Project this event belongs to; null for an account recovery. |
data.operation_id | string UUID | The operation being undone. |
data.kind | string | account or resources; a bot replacement cannot be undone. |
data.connector | string | null | The connector the recovery acted on. |
data.project_id | string UUID | null | The project, or null for an account recovery. |
data.resource_id | string UUID | null | The resource put back onto its old chat; null for an account relink. |
data.reverted_at | ISO 8601 timestamp | When the undo happened. |
Caveats
- Undoing a swap re-admits every active member into the old chat again; expect a second round of
member.resource_*events for the same members. - The undo window is 24 hours from completion by default; an attempt after it is refused and fires nothing.
Related events
recovery.operation_completed— the recovery being undone.recovery.incident_opened— the disputed-relink incident an account undo opens.- Recovery events overview — back to family overview.
How is this guide?