Disaster Recovery

Remind a recovery's stragglers

curl -X POST https://api.subscriby.net/v1/recovery/operations/$OPERATION_ID/nudge \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

Sends one reminder, with a fresh link, to every member a channel recovery re-admitted who has not joined the new chat yet, and records the nudge on the operation. Read the roll call first: can_nudge says whether anyone is still outside and the cooldown has passed. Answers 200 with the count queued.

post/v1/recovery/operations/{operation}/nudge

Request

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

Path parameters

operationstring uuid required

The operation, resolved within the ledger 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 operation_id and how many reminders were nudged.

Example response

{
  "data": {
    "operation_id": "9a4d2e71-5b38-4c6f-8e12-3d7c9b0a5f21",
    "nudged": 2
  }
}

Changes

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