diff --git a/doc/source/architecture.rst b/doc/source/architecture.rst
index 6df6f1f90..047d23713 100644
--- a/doc/source/architecture.rst
+++ b/doc/source/architecture.rst
@@ -479,4 +479,4 @@ change to a new value:
 
 
 
-.. _Watcher API: https://developer.openstack.org/api-ref/resource-optimization/
+.. _Watcher API: https://docs.openstack.org/api-ref/resource-optimization/
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 83069cc46..1fb8e80ed 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -83,7 +83,7 @@ API References
 .. toctree::
   :maxdepth: 1
 
-  API Reference <https://developer.openstack.org/api-ref/resource-optimization/>
+  API Reference <https://docs.openstack.org/api-ref/resource-optimization/>
   Watcher API Microversion History </contributor/api_microversion_history>
 
 Plugins
diff --git a/watcher/common/placement_helper.py b/watcher/common/placement_helper.py
index 405bbcb28..7c34bcb90 100644
--- a/watcher/common/placement_helper.py
+++ b/watcher/common/placement_helper.py
@@ -33,7 +33,7 @@ class PlacementHelper(object):
     @staticmethod
     def get_error_msg(resp):
         json_resp = resp.json()
-        # https://developer.openstack.org/api-ref/placement/#errors
+        # https://docs.openstack.org/api-ref/placement/#errors
         if 'errors' in json_resp:
             error_msg = json_resp['errors'][0].get('detail')
         else:
diff --git a/watcher/decision_engine/model/element/volume.py b/watcher/decision_engine/model/element/volume.py
index ededef5e4..c3e08f45a 100644
--- a/watcher/decision_engine/model/element/volume.py
+++ b/watcher/decision_engine/model/element/volume.py
@@ -22,7 +22,7 @@ from watcher.objects import fields as wfields
 
 
 class VolumeState(enum.Enum):
-    # https://developer.openstack.org/api-ref/block-storage/v3/#volumes-volumes
+    # https://docs.openstack.org/api-ref/block-storage/v3/#volumes-volumes
 
     CREATING = 'creating'
     AVAILABLE = 'available'