diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index 5ea19faab9..453c2e0f77 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -1556,6 +1556,8 @@ addresses:
   description: |
     The addresses for the server.  Servers with status ``BUILD`` hide their
     addresses information.
+    This view is not updated immediately.
+    Please consult with OpenStack Networking API for up-to-date information.
   in: body
   required: true
   type: object