diff --git a/README.rst b/README.rst
index 48cb5ff..d0b267e 100644
--- a/README.rst
+++ b/README.rst
@@ -22,6 +22,8 @@
           bind9:
             rndc_key: 4pc+X4PDqb2q+5o72dISm72LM1Ds9X2EYZjqg+nmsS7FhdTwzFFY8l/iEDmHxnyjkA33EQC8H+z0fLLBunoitw==
             rndc_algorithm: hmac-sha512
+        api:
+          base_uri: 'http://127.0.0.1:9001'
         bind:
           api:
             address: 127.0.0.1
@@ -79,6 +81,11 @@
    is deployed and zone is created, this parameter should be updated accordingly to UUID of
    newly created zone. Then designate state should be reapplied.
 
+.. note::
+   *server:api:base_uri* allows to set URL which is returned in designate-api responses, it is
+   useful in cases when, designate-api is deployed under proxy server. If not overriden in reclass,
+   it defaults to http://*server:bind:api:address*:9001/.
+
 Pools pillar for BIND9 master and multiple slaves setup:
 
 .. code:: yaml