Disaster Recovery

Get a recovery operation

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

One operation, with its undo state.

  • status is started while the recovery runs, then completed, failed (with failure_reason) or reverted.
  • revertible says whether the creator may still undo it right now: it is completed, of a kind that can be undone (an account relink or a channel swap, never a bot replacement), and inside the undo window that revert_window_ends_at closes. A client should show the undo exactly when this is true.
  • grant_id names the support grant that paid for the recovery when the self-service allowance was already spent; null otherwise.
get/v1/recovery/operations/{operation}

Request

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

Path parameters

operationstring uuid required

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

Response

200 with the operation.

Example response

{
  "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",
    "automatic": true,
    "started_at": "2026-09-12T03:19:10Z",
    "completed_at": "2026-09-12T03:19:42Z",
    "revertible": true,
    "revert_window_ends_at": "2026-09-13T03:19:42Z"
  }
}

Changes

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