Explain why e2e previews are bad

5 years ago · f012da17a1
parent b662a33081
commit f012da17a1
1 changed files with 3 additions and 1 deletions
--- a/api/client-server/content-repo.yaml
+++ b/api/client-server/content-repo.yaml
@ -346,7 +346,9 @@ paths:

        .. Note::
          Clients should consider avoiding this endpoint for URLs posted in encrypted
-          rooms.
+          rooms. Encrypted rooms often contain more sensitive information the users
+          do not want to share with the homeserver, and this can mean that the URLs
+          being shared should also not be shared with the homeserver.

      operationId: getUrlPreview
      produces: ["application/json"]