Disaster Recovery

Get a recovery's roll call

curl https://api.subscriby.net/v1/recovery/operations/$OPERATION_ID/roll-call \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

Where the re-admission after a channel recovery stands, read live.

  • total is how many members the swap set out to re-admit; regranted how many hold a fresh link into the new chat; failed how many could not be given one.
  • unreachable is how many the bot could not message, and emailed how many of those were told by email instead (at the per-email fee, when the project opted in).
  • joined is stamped the moment the platform approves a member's join request, so pending (regranted − joined) is who is still outside.
  • settled means the queue has handled everyone, so the counters will not move on their own. can_nudge is true when somebody is still outside and the reminder cooldown has passed; cooling_down and nudge_available_at explain a false.

A recovery of a kind that re-admits nobody (an account relink, a bot replacement) answers the same shape with every counter at zero rather than an error.

get/v1/recovery/operations/{operation}/roll-call

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/recovery/operations/{operation}/roll-call
  • Auth: HTTP bearer

Path parameters

operationstring uuid required

The operation, resolved within the ledger by the route binder.

Response

200 with the counters.

Example response

{
  "data": {
    "total": 340,
    "regranted": 340,
    "unreachable": 12,
    "emailed": 12,
    "joined": 338,
    "pending": 2,
    "nudged": 1,
    "settled": true,
    "can_nudge": true,
    "last_nudged_at": "2026-09-12T09:00:00Z",
    "nudge_available_at": "2026-09-12T10:00:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.