get_recovery_roll_call

Read where the re-admission after one Disaster Recovery operation stands — how many members hold a fresh link, how many have joined, who is still outside, and whether a reminder may go out now.

Purpose

After a channel or group is swapped, every active member is re-admitted through a fresh link, and this is the live tally: how many the swap set out to re-admit (total), how many hold a new link (regranted), how many could not be given one (failed), how many the installation could not message (unreachable) and were told by email instead (emailed), how many have joined (joined), who is still outside (pending), how many reminders went out (nudged), whether the queue has handled everyone (settled), and whether the creator may remind the stragglers right now (can_nudge, with nudge_available_at while the cooldown runs). The payload is exactly what GET /v1/recovery/operations/{operation}/roll-call returns.

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

Required ability

project-recovery:view

Input schema

{
  "type": "object",
  "required": ["operation_id"],
  "properties": {
    "operation_id": { "type": "string", "description": "UUID of the recovery operation, from list_recovery_operations." }
  }
}

Output shape

{
  "data": {
    "total": 340,
    "regranted": 340,
    "failed": 0,
    "unreachable": 12,
    "emailed": 12,
    "joined": 338,
    "pending": 2,
    "nudged": 1,
    "settled": true,
    "cooling_down": false,
    "can_nudge": true,
    "last_nudged_at": "2026-09-12T09:00:00Z",
    "nudge_available_at": "2026-09-12T10:00:00Z"
  },
  "meta": { "operation_id": "9a4d2e71-5b38-4c6f-8e12-3d7c9b0a5f21" }
}

Example prompts

"How many members are still outside after last night's failover of Lounge?"

"Has everyone re-joined after the Signals swap, or should I remind them?"

Failure modes

RESOURCE_NOT_FOUND — operation_id is not an operation in this creator's ledger.
AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks project-recovery:view.

list_recovery_operations — find the operation.
Recovery API
What members see