1 files changed, 5 insertions, 0 deletions
diff --git a/container-core/src/main/java/com/yahoo/restapi/RestApi.java b/container-core/src/main/java/com/yahoo/restapi/RestApi.java
index d15a94bea30..74dd6b6a433 100644
--- a/container-core/src/main/java/com/yahoo/restapi/RestApi.java
+++ b/container-core/src/main/java/com/yahoo/restapi/RestApi.java
@@ -128,6 +128,11 @@ public interface RestApi {
         Optional<RequestContent> requestContent();
         RequestContent requestContentOrThrow();
         ObjectMapper jacksonJsonMapper();
+        /**
+         * Creates a URI builder pre-initialized with scheme, host and port.
+         * Intended for response generation (e.g for interactive REST APIs).
+         * DO NOT USE FOR CUSTOM ROUTING.
+         */
         UriBuilder uriBuilder();
         AclMapping.Action aclAction();
         Optional<Principal> userPrincipal();