Store a one-read secret ($0.03)

POST the secret as the raw body. Returns a URL readable exactly once — the read destroys it before responding. The reader pays nothing. Max 4096 bytes; ttl 60s to 24h. Encrypted at rest with an AES-256-GCM key returned to you once and not kept, so a breach of our storage yields ciphertext; pass blind=true to store your own ciphertext untouched instead.

post/v1/secret

Request

  • Base URL: https://soren.com
  • URL: https://soren.com/v1/secret
  • Auth: none declared

Query parameters

ttlinteger

Seconds until it self-destructs unread. Default 3600.

blindboolean

Store the body untouched with no server-side encryption. Use when you have already encrypted and want Soren to generate no key at all.

Response

Stored.

storedboolean
read_urlstring
tokenstring
expires_atstring date-time
reads_allowedinteger

Changes

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