> For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

# RecoveryEvent

> Event emitted when a recovery action is taken on a call.

Event emitted when a recovery action is taken on a call.

## **Properties**

**`action`** `'keyframe_requested' | 'reinvite_started' | 'reinvite_succeeded' | 'reinvite_failed' | 'reinvite_timeout' | 'max_attempts_reached' | 'call_recovering' | 'call_recovered' | 'call_recovery_failed' | 'signal_reconnect' | 'full_reconnect' | 'video_disabled' | 'video_restored'` — required

The recovery action that was taken.

---

**`attempt`** `number`

Current attempt number (for multi-attempt recoveries).

---

**`maxAttempts`** `number`

Maximum number of attempts allowed.

---

**`reason`** `string` — required

Human-readable description of why recovery was triggered.

---

**`timestamp`** `number` — required

Timestamp when the event occurred (epoch ms).

---