Skip to main content
POST
Recover encrypted backup data

Authorizations

X-API-Key
string
header
required

API key for authentication and authorization

Body

application/json
user_identifier
string
required

User identifier (REQUIRED)

Example:

"john.doe@example.com"

verification_id
string
required

Verification ID from a successful verification. (REQUIRED) Must be approved/successful.

Example:

"inq_abc123xyz"

gpg_public_key
string

GPG public key in PGP public key block format. The recovered data is encrypted to it. Provide exactly one of gpg_public_key or rsa_public_key.

Pattern: ^-----BEGIN PGP PUBLIC KEY BLOCK-----[\s\S]*?-----END PGP PUBLIC KEY BLOCK-----$
Example:

"-----BEGIN PGP PUBLIC KEY BLOCK-----\n...\n-----END PGP PUBLIC KEY BLOCK-----"

rsa_public_key
string

RSA public key (PEM SPKI, or hex-encoded SPKI DER). The recovered data is encrypted to it: rsa-direct for small payloads, hybrid-rsa-aes256-gcm otherwise. Use a one-time key generated on the user's device so only that device can read the result. Provide exactly one of gpg_public_key or rsa_public_key.

Example:

"-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"

Response

200 - application/json

Backup recovered successfully

backup
object[]
required

Array of recovered backup items. Each item contains recovery information or error details.