Back to Subscriby

recovery.standby_removed

A standby is no longer kept: the creator removed it, registered another in its place, or a recovery consumed it.

Ability to subscribeproject-recovery:view

When this fires

A standby bot or standby chat leaves the reserve. reason says why: removed when the creator took it away, replaced when a new standby bot took the slot, used when a recovery consumed it (a bot relink from the standby, a one-click Swap & Grant onto the standby chat, or an automatic failover).

Caveats

  • A standby consumed by a recovery fires this beside the recovery's own events (recovery.resource_failed_over or recovery.resource_replaced, or the bot recovery's recovery.operation_completed); use reason: used to tell it from a deliberate removal.
  • The readiness checklist counts standbys, so a removed or used standby lowers the score until a new one is registered.

Related events

  • recovery.standby_registered: the standby being kept.

Header Parameters

SB-Signature*string

t=<unix seconds>,v1=<hex>: the HMAC-SHA256 of "<t>.<raw body>" under the endpoint's secret. Verify it before acting, and refuse a t more than 300 seconds from now. During a secret rotation a v0= signature under the previous secret may precede v1=.

SB-Event-Id*string

The event's ULID, bare. The envelope's id is the same ULID prefixed evt_, so strip the prefix before comparing. Deduplicate on it: a retry carries the same id.

SB-Event-Name*string

The event name, the same as the envelope's type.

Content-Type*string

Always application/json.

User-Agent*string

Always Subscriby-Webhooks/1.0.

Request Body

application/json

The signed JSON envelope posted to your endpoint.

TypeScript Definitions

Use the request body type in TypeScript.

The envelope every event is delivered in.

Response Body

Example Requests

POST/recovery.standby_removed

How is this guide?

recovery.standby_registered Webhook

A spare bot is kept ready for a project, or a spare channel or group is kept ready for one resource.

recovery.installation_failed_over Webhook

Automatic failover switched a project onto its standby bot without the creator, because the platform refused the live one: the bot-side twin of recovery.resourcefailedover.