diff --git a/README.rst b/README.rst
index 1caee25bf0..28d9476eed 100644
--- a/README.rst
+++ b/README.rst
@@ -28,7 +28,7 @@ Project resources
 * Source: https://opendev.org/openstack/ironic
 * Bugs: https://storyboard.openstack.org/#!/project/943
 * Wiki: https://wiki.openstack.org/wiki/Ironic
-* APIs: https://developer.openstack.org/api-ref/baremetal/index.html
+* APIs: https://docs.openstack.org/api-ref/baremetal/index.html
 * Release Notes: https://docs.openstack.org/releasenotes/ironic/
 
 Project status, bugs, and requests for feature enhancements (RFEs) are tracked
diff --git a/doc/source/admin/cleaning.rst b/doc/source/admin/cleaning.rst
index 8ef672b562..5960c0f3f7 100644
--- a/doc/source/admin/cleaning.rst
+++ b/doc/source/admin/cleaning.rst
@@ -105,7 +105,7 @@ higher::
 
     PUT /v1/nodes/<node_ident>/states/provision
 
-(Additional information is available `here <https://developer.openstack.org/api-ref/baremetal/index.html?expanded=change-node-provision-state-detail#change-node-provision-state>`_.)
+(Additional information is available `here <https://docs.openstack.org/api-ref/baremetal/index.html?expanded=change-node-provision-state-detail#change-node-provision-state>`_.)
 
 This API will allow operators to put a node directly into ``cleaning``
 provision state from ``manageable`` state via 'target': 'clean'.
diff --git a/doc/source/admin/node-deployment.rst b/doc/source/admin/node-deployment.rst
index 4c095c2f34..e4acf29a6e 100644
--- a/doc/source/admin/node-deployment.rst
+++ b/doc/source/admin/node-deployment.rst
@@ -178,7 +178,7 @@ single step:
    }
 
 Further information on this API is available `here
-<https://developer.openstack.org/api-ref/baremetal/index.html?expanded=create-deploy-template-detail#create-deploy-template>`__.
+<https://docs.openstack.org/api-ref/baremetal/index.html?expanded=create-deploy-template-detail#create-deploy-template>`__.
 
 Creating a deploy template via "openstack baremetal" client
 -----------------------------------------------------------
diff --git a/doc/source/admin/raid.rst b/doc/source/admin/raid.rst
index db98bc84e2..fd39dca47b 100644
--- a/doc/source/admin/raid.rst
+++ b/doc/source/admin/raid.rst
@@ -12,7 +12,7 @@ API.  The desired RAID configuration is applied on the bare metal during manual
 cleaning.
 
 The examples described here use the OpenStackClient CLI; please see the
-`REST API reference <https://developer.openstack.org/api-ref/baremetal/>`_
+`REST API reference <https://docs.openstack.org/api-ref/baremetal/>`_
 for their corresponding REST API requests.
 
 Prerequisites
diff --git a/doc/source/admin/security.rst b/doc/source/admin/security.rst
index d15b46c4a0..09f997e922 100644
--- a/doc/source/admin/security.rst
+++ b/doc/source/admin/security.rst
@@ -174,7 +174,7 @@ API endpoints for RAM disk use
 ------------------------------
 
 There are `two (unauthorized) endpoints
-<https://developer.openstack.org/api-ref/baremetal/#utility>`_ in the
+<https://docs.openstack.org/api-ref/baremetal/#utility>`_ in the
 Bare Metal API that are intended for use by the ironic-python-agent RAM disk.
 They are not intended for public use.
 
diff --git a/doc/source/index.rst b/doc/source/index.rst
index b07c1c8eaf..176b4e9bb8 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -74,7 +74,7 @@ guide as well as more detailed reference documentation.
   :maxdepth: 1
 
   API Concept Guide <contributor/webapi>
-  API Reference (latest) <https://developer.openstack.org/api-ref/baremetal/>
+  API Reference (latest) <https://docs.openstack.org/api-ref/baremetal/>
   API Version History <contributor/webapi-version-history>
 
 Command References
diff --git a/ironic/dhcp/neutron.py b/ironic/dhcp/neutron.py
index 9764e34dac..304ca395ee 100644
--- a/ironic/dhcp/neutron.py
+++ b/ironic/dhcp/neutron.py
@@ -40,7 +40,7 @@ class NeutronDHCPApi(base.BaseDHCP):
 
         Update one or more DHCP options on the specified port.
         For the relevant API spec, see
-        https://developer.openstack.org/api-ref/network/v2/index.html#update-port
+        https://docs.openstack.org/api-ref/network/v2/index.html#update-port
 
         :param port_id: designate which port these attributes
                         will be applied to.