list_recovery_operations

List every Disaster Recovery operation of the creator the token acts for — by the creator, the platform or on demand — with its state and whether it can still be undone.

Purpose

Answer "what has recovery done for me, and can I still undo it?". An operation is one recovery ever run: by the creator, by the platform on their behalf (automatic, the failover you sleep through) or on demand (on_demand, a Swap & Grant of a healthy resource). Each row carries its kind, its state, the connector and project, when it started and finished, the failure reason when it failed, and its undo state: revertible for whether it can be undone right now and revert_window_ends_at for when that closes. The rows are the ones GET /v1/recovery/operations returns.

Required ability

project-recovery:view-any

Input schema

{
  "type": "object",
  "properties": {
    "kind": { "type": "string", "enum": ["account", "bot", "resources"], "description": "Only recoveries of this kind. Omit for every kind." },
    "status": { "type": "string", "enum": ["started", "completed", "failed", "reverted"], "description": "Only operations in this state. Omit for every state." },
    "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "Operations per page (default 25)." },
    "page": { "type": "integer", "minimum": 1, "description": "1-indexed page number." }
  }
}

Output shape

{
  "data": [
    {
      "id": "9a4d2e71-5b38-4c6f-8e12-3d7c9b0a5f21",
      "kind": "resources",
      "kind_label": "Channels and Groups",
      "status": "completed",
      "status_label": "Completed",
      "connector": "telegram",
      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
      "project_name": "Research Premium",
      "grant_id": null,
      "automatic": true,
      "on_demand": false,
      "failure_reason": null,
      "started_at": "2026-09-12T03:19:10Z",
      "completed_at": "2026-09-12T03:19:42Z",
      "reverted_at": null,
      "revertible": true,
      "revert_window_ends_at": "2026-09-13T03:19:42Z"
    }
  ],
  "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false }
}

Example prompts

"Did the platform fail anything over for me last night?"

"Which of my channel swaps can I still undo?"

Failure modes

VALIDATION_FAILED — kind or status is not one of the accepted values; the context names them.
AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks project-recovery:view-any.

get_recovery_roll_call — where the re-admission after one operation stands.
list_recovery_incidents — the problems these operations answered.
Recovery API
History and Undo