diff --git a/doc/source/admin/production-guidelines.rst b/doc/source/admin/production-guidelines.rst
index cb0144867..eb26399da 100644
--- a/doc/source/admin/production-guidelines.rst
+++ b/doc/source/admin/production-guidelines.rst
@@ -107,4 +107,4 @@ In the main PowerDNS configuration file, include the following statement::
 .. _IANA TLD list: https://data.iana.org/TLD/tlds-alpha-by-domain.txt
 .. _Public Suffix list: https://publicsuffix.org/
 .. _Bug 1471159: https://bugs.launchpad.net/designate/+bug/1471159
-.. _TLD API: http://developer.openstack.org/api-ref/dns/#tld
+.. _TLD API: https://docs.openstack.org/api-ref/dns/#tld
diff --git a/doc/source/admin/upgrades/newton.rst b/doc/source/admin/upgrades/newton.rst
index 7f4fd2d23..8e14da445 100644
--- a/doc/source/admin/upgrades/newton.rst
+++ b/doc/source/admin/upgrades/newton.rst
@@ -93,11 +93,11 @@ New Features
   djbdns tools.
 - An experimental agent backend to support Knot DNS 2
 - A new recordset api ``/v2/recordsets`` is exposed, docs can be found
-  `here <https://developer.openstack.org/api-ref/dns/#list-all-recordsets-owned-by-project>`_.
+  `here <https://docs.openstack.org/api-ref/dns/#list-all-recordsets-owned-by-project>`_.
 - Designate services now report running status. The information is exposed via
-  `api <https://developer.openstack.org/api-ref/dns/#service-statuses>`_.
+  `api <https://docs.openstack.org/api-ref/dns/#service-statuses>`_.
 - The quotas API from the admin API has been ported to /v2 with some changes
-  and is now `stable <https://developer.openstack.org/api-ref/dns/#quotas>`_.
+  and is now `stable <https://docs.openstack.org/api-ref/dns/#quotas>`_.
 
 Deprecation Notices
 -------------------
diff --git a/doc/source/contributor/ubuntu-dev.rst b/doc/source/contributor/ubuntu-dev.rst
index 7c0bdee44..841f105cf 100644
--- a/doc/source/contributor/ubuntu-dev.rst
+++ b/doc/source/contributor/ubuntu-dev.rst
@@ -361,4 +361,4 @@ the ``auth_strategy = keystone`` in the ``service:api`` section.
 This will make it easier to use clients like the ``openstack``
 CLI that expect Keystone.
 
-.. _api-ref: https://developer.openstack.org/api-ref/dns/
+.. _api-ref: https://docs.openstack.org/api-ref/dns/
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 666c916e9..3fd74000b 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -21,7 +21,7 @@ Contents
     cli/index
 
 For information on the Designate API, see the
-`API Reference <https://developer.openstack.org/api-ref/dns/>`_.
+`API Reference <https://docs.openstack.org/api-ref/dns/>`_.
 
 This documentation is generated by the Sphinx toolkit and lives in the
 `source tree <https://opendev.org/openstack/designate>`_.
diff --git a/doc/source/user/rest.rst b/doc/source/user/rest.rst
index 4e4a733a8..3cbd1f1d1 100644
--- a/doc/source/user/rest.rst
+++ b/doc/source/user/rest.rst
@@ -73,4 +73,4 @@ Admin API
 
        rest/admin/quotas
 
-.. _api site: http://developer.openstack.org/api-ref/dns/
+.. _api site: https://docs.openstack.org/api-ref/dns/
diff --git a/tox.ini b/tox.ini
index 3b73b3cc3..cc9dc0161 100644
--- a/tox.ini
+++ b/tox.ini
@@ -142,7 +142,7 @@ commands=pip-missing-reqs -d --ignore-file=designate/tests/* designate
 [testenv:api-ref]
 basepython = python3
 # This environment is called from CI scripts to test and publish
-# the API Ref to developer.openstack.org.
+# the API Ref to docs.openstack.org.
 deps =
   -c{env:UPPER_CONSTRAINTS_FILE:https://git.openstack.org/cgit/openstack/requirements/plain/upper-constraints.txt}
   -r{toxinidir}/doc/requirements.txt