Disaster Recovery

List incidents

curl "https://api.subscriby.net/v1/recovery/incidents?status=open" \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

An incident is one problem a probe detected and has not yet seen fixed: the creator's sign-in account unreachable (kind: account), a project's bot refused by the platform (bot), or a channel or group the project sells gone or no longer administered (resources). It resolves itself when a later probe finds the thing healthy, or is resolved by the recovery that replaced it, which resolved_by_operation_id then names.

status is open (the default: what still needs attention), resolved, or all. Paginated like every list, newest first by detected_at; sort_by also accepts kind, status and resolved_at.

get/v1/recovery/incidents

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/recovery/incidents
  • Auth: HTTP bearer

Query parameters

status'open' | 'resolved' | 'all'

Which recovery incidents a list shows. Open is what still needs attention, so it is the default: an integration polling the list wants the problems, not the archive. Resolved is the record of what healed or was fixed; All is both.

The tab: open (the default, what still needs attention), resolved, or all.

pageinteger

The 1-based page to return. A page past the last answers an empty data array with meta.total still filled, so a loop can stop without guessing.

per_pageinteger

Rows per page, 1 to 100. A higher value clamps to the cap silently. Defaults to 25.

sort_bystring

The column to order by. Defaults to detected_at; a column the endpoint does not offer falls back to the default rather than failing.

sort_direction'asc' | 'desc'

asc or desc. Defaults to desc.

Response

The page, newest first by default.

Example response

{
  "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:** the platform deleted or banned the channel. Replace it with a new one.",
      "detected_at": "2026-09-12T03:19:04Z"
    }
  ]
}

Changes

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