{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/api-reference/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"API Reference","searchWeight":120,"type":"markdown"},"seo":{"title":"Encrypted areas","description":"Complete API reference and documentation for Freddy AI-powered backend system by Aitronos","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"encrypted-areas","__idx":0},"children":["Encrypted areas"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["encrypted area"]}," is a block of text or a file that is encrypted end-to-end: Aitronos"," ","servers store only ciphertext and never hold a key that can read it. A sender attaches an"," ","encrypted area in chat and sends it to another Aitronos user, an email address, a messaging"," ","number, or as a shareable ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["secure link"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are two flavours:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Recipient-bound"]}," — sealed to a specific Aitronos user. Only that user's identity can open"," ","it; if the message is forwarded, the area stays sealed to the original recipient."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Secure link"]}," — protected by a key that travels in the link (optionally further protected by"," ","a password the sender sets out-of-band). Supports ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["burn-after-read"]}," (self-destructs on first"," ","open) and a configurable ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["expiry"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In every case the storage layer holds only ciphertext — a compromise of storage yields no"," ","plaintext and no key. Recipients open the area on an Aitronos-branded viewer and it decrypts on"," ","their device. Files of any size are supported."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Encrypted areas are part of Conversations: where Conversations is enabled for your account they"," ","are enabled with it, and where Conversations is switched off the create endpoint answers ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["403"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"creating-an-encrypted-area","__idx":1},"children":["Creating an encrypted area"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/encrypted-areas/create"},"children":["Create an encrypted area"]}," encrypts inline text or an uploaded file, seals it for"," ","the audience you choose, and either delivers it for you or returns a shareable secure link."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Three rules are worth knowing before you call it:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The secure link is returned exactly once and can never be re-issued."]}," The key inside it is"," ","never stored, so nobody — including Aitronos — can produce it again. Capture it from the"," ","response or create a new area."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The link is returned only for the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["link"]}," audience."]}," Every other audience is delivered for"," ","you, so the response withholds the key-bearing URL."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The endpoint is not idempotent."]}," Repeating a request creates a second, independent area"," ","with its own key; there is no de-duplication."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["By default an area expires after 7 days; a password and burn-after-read are off unless you ask"," ","for them."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"opening-an-encrypted-area","__idx":2},"children":["Opening an encrypted area"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both open flows are simple GET fetches that return the ciphertext plus the public parameters your"," ","client needs to decrypt on-device:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/encrypted-areas/fetch-recipient-bound"},"children":["Fetch a recipient-bound encrypted area"]}," — authenticated; the"," ","caller must be the bound recipient."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/encrypted-areas/fetch-secure-link"},"children":["Fetch a secure-link encrypted area"]}," — public; possession of the link"," ","is the credential."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both refuse an area that has ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["expired"]}," or, for a burn-after-read area, that has ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["already been"," ","opened"]},", returning ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["410"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-resources","__idx":3},"children":["Related resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/encrypted-areas/create"},"children":["Create an encrypted area"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/encrypted-areas/fetch-recipient-bound"},"children":["Fetch a recipient-bound encrypted area"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/api-reference/encrypted-areas/fetch-secure-link"},"children":["Fetch a secure-link encrypted area"]}]}]}]},"headings":[{"value":"Encrypted areas","id":"encrypted-areas","depth":1},{"value":"Creating an encrypted area","id":"creating-an-encrypted-area","depth":2},{"value":"Opening an encrypted area","id":"opening-an-encrypted-area","depth":2},{"value":"Related resources","id":"related-resources","depth":2}],"frontmatter":{"title":"Encrypted areas","keywords":["encrypted area","secure link","end-to-end encryption","burn after read"],"seo":{"title":"Encrypted areas"}},"lastModified":"2026-10-26T18:32:31.569Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/api-reference/encrypted-areas/introduction","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}