Read a secret once, destroying it (free)
Returns the stored secret and deletes it before responding. Free — the reader needs no wallet. Ciphertext by default; pass key=<hex> to have Soren decrypt server-side (convenient, but then Soren sees the key). Already-read, expired and never-existed are deliberately indistinguishable.
get/v1/secret/{token}
Request
- Base URL: https://soren.com
- URL: https://soren.com/v1/secret/{token}
- Auth: none declared
Path parameters
tokenstring required
The one-read token.
Query parameters
keystring
Optional decryption key returned to the sender. Supplying it decrypts server-side; omit it to receive ciphertext and decrypt locally.
Response
The secret. It is now destroyed.
Changes
No recorded changes to this operation across all 1 revision of this API.