diff --git a/api/client-server/content-repo.yaml b/api/client-server/content-repo.yaml
index 582d0695..8ccc7684 100644
--- a/api/client-server/content-repo.yaml
+++ b/api/client-server/content-repo.yaml
@@ -276,9 +276,11 @@ paths:
                All values are intentionally left optional. Clients SHOULD follow
                the advice given in the field description when the field is not available.
 
-               **NOTE:** The /config endpoint is a guide. Other middleware such as 
-               reverse proxies may apply their own configuration not described on this
-               endpoint.
+               **NOTE:** Both clients and server administrators should be aware that proxies
+               between the client and the server may affect the apparent behaviour of content
+               repository APIs, for example, proxies may enforce a lower upload size limit
+               than is advertised by the server on this endpoint. Clients should handle such
+               situations gracefully.
       operationId: getConfig
       produces: ["application/json"]
       security: