Disaster Recovery

Register a backup account

curl -X POST https://api.subscriby.net/v1/me/recovery/backup-identity \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"handshake_id": "0c4f9e2a-7b31-4d68-a5e2-9f1c3b7d6e80"}'

Registers the account a completed backup handshake detected as the backup (Growth plan). Answers 200 with the account summary.

post/v1/me/recovery/backup-identity

Request

Base URL: https://api.subscriby.net
URL: https://api.subscriby.net/v1/me/recovery/backup-identity
Auth: HTTP bearer

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.

Request body

handshake_idstring uuid required

A backup handshake of the caller's in state completed; the account that tapped it becomes the backup.

Response

200 with the account summary.

Example response

{
  "data": {
    "primary_display_name": "Ada",
    "backup_identity_registered": true,
    "backup_display_name": "Backup Ada"
  }
}

Changes

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