Disaster Recovery

Request a standby for a resource

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

Asks the creator, on the connector, to pick the chat that becomes the resource's standby (Growth plan). Answers 202 once the request is sent; the standby appears, announced by recovery.standby_registered, the moment they choose.

Linking a standby or a replacement is a conversation with the creator on the connector: the bot messages them with a picker, and the link or the swap happens the moment they choose. The API cannot name the chat directly, because that would take a platform identifier, so it starts the conversation and takes it back. A creator holds one request of each kind at a time, whichever resource it was for.

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

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/projects/{project}/resources/{resource}/standby/request
  • 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

202 with resource_id and status: request_sent.

Example response

{
  "data": {
    "resource_id": "b73c5f21-9d80-4a6e-8215-4f70ce13a9d6",
    "status": "request_sent"
  }
}

Changes

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