Disaster Recovery

Use a resource's standby now

curl -X POST https://api.subscriby.net/v1/projects/$PROJECT_ID/resources/$RESOURCE_ID/standby/use \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

Swaps the resource onto its standby right now: the resource points at the standby chat, the old invite links are revoked, every active member is re-admitted, and the standby is consumed. Answers 200 with the recovery operation the swap ran under (on_demand: true when the resource was healthy with no open incident, spending no allowance). Undo is offered for 24 hours through the revert endpoint. Raises recovery.resource_replaced and recovery.standby_removed with reason: used, beside the operation's recovery.operation_started and recovery.operation_completed.

post/v1/projects/{project}/resources/{resource}/standby/use

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/projects/{project}/resources/{resource}/standby/use
  • Auth: HTTP bearer

Path parameters

projectstring uuid required

The project, resolved by the route binder.

resourcestring uuid required

The resource, resolved within the project by the route binder.

Headers

Idempotency-Keystring uuid required

A key unique to this operation, such as a fresh UUID. The same key replays the original 2xx response for 24 hours (with Idempotent-Replay: true), so a retry after a timeout never repeats the write; the same key with a different body is refused with 409.

Response

200 with the recovery operation the swap ran under.

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.