list_recovery_incidents

List the Disaster Recovery incidents of the creator the token acts for — what the health probes found broken, open by default, with the reason in the connector's words.

Purpose

Answer "is anything of mine banned or broken right now?". An incident is one problem a probe detected and has not yet seen fixed: the creator's sign-in account unreachable (account), a project's installation refused by the platform (bot), or a space the project sells gone or no longer administered (resources). Each row names the connector, the project and resource, the reason as the connector's code and in words, when it was detected and, once healed or fixed, when and by which operation it was resolved. The rows are the ones GET /v1/recovery/incidents returns.

Required ability

project-recovery:view-any

Input schema

{
  "type": "object",
  "properties": {
    "status": { "type": "string", "enum": ["open", "resolved", "all"], "description": "Which incidents: open (default), resolved, or all." },
    "limit": { "type": "integer", "minimum": 1, "maximum": 100, "description": "Incidents per page (default 25)." },
    "page": { "type": "integer", "minimum": 1, "description": "1-indexed page number." }
  }
}

Output shape

{
  "data": [
    {
      "id": "6f1e9b27-4c3a-4d58-9e02-b7a1c5d38f64",
      "kind": "resources",
      "kind_label": "Channels and Groups",
      "status": "open",
      "status_label": "Open",
      "connector": "telegram",
      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
      "project_name": "Research Premium",
      "resource_id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",
      "resource_title": "Signals",
      "reason": "chat_not_found",
      "reason_label": "Channel not found",
      "reason_explanation": "**Most likely cause:** Telegram deleted or banned the channel. Replace it with a new one.",
      "detected_at": "2026-09-12T03:19:04Z",
      "resolved_at": null,
      "resolved_by_operation_id": null
    }
  ],
  "meta": { "page": 1, "limit": 25, "total": 1, "has_more": false }
}

Example prompts

"Is any of my channels banned right now?"

"Show me every recovery incident from the last quarter, resolved ones included."

Failure modes

AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks project-recovery:view-any.

list_recovery_operations — what was done about them.
get_recovery_readiness — how ready the account is for the next one.
Recovery API
How detection works