v1

latestOpenAPI 3.1.02026-07-241280174.1 KB

E2E Encrypted

Generate a Doppler Share link by sending an encrypted secret. The receive flow the user goes through will be end-to-end encrypted where the encrypted secret will be decrypted on the browser.

post/v1/share/secrets/encrypted

Request body

encrypted_secretstring required

Ecrypted secret using AES-GCM with a symmetric key derived from a cryptographically random 64 character passphrase using PBKDF2. 1,000,000 salt rounds required. Then base64 encode the encrypted secret.

hashed_passwordstring required

SHA256 hash of the password. This is NOT the hash of the derived encryption key.

expire_viewsinteger

Number of views before the link expires. Valid ranges: 1 to 50. -1 for unlimited.

expire_daysinteger

Number of days before the link expires. Valid range: 1 to 90.

encryption_kdfstring required

The key derivation function used. Must by "pbkdf2".

encryption_salt_roundsinteger required

Number of salt rounds used by KDF. Must be "1000000".

Response

200

urlstring

successboolean

Example response

{
  "url": "https://share.doppler.com/s/oarjigpajqtodoqefoua9o1iisdfaocgfbulmaez#GZPgKEngtasgXHftCjimCwjPquZV7qwwzo8qb1m7rgvjlWXFr8C5jHOuXtxW1SBC",
  "success": true
}