diff --git a/aodh/api/controllers/root.py b/aodh/api/controllers/root.py
index b66d1770d..93b9a691b 100644
--- a/aodh/api/controllers/root.py
+++ b/aodh/api/controllers/root.py
@@ -37,7 +37,7 @@ def version_descriptor(base_url, version, released_on):
         'id': version,
         'links': [
             {'href': url, 'rel': 'self', },
-            {'href': 'http://docs.openstack.org/',
+            {'href': 'https://docs.openstack.org/',
              'rel': 'describedby', 'type': 'text/html', }],
         'media-types': [
             {'base': 'application/json', 'type': MEDIA_TYPE_JSON % version, },
diff --git a/aodh/tests/functional/api/test_versions.py b/aodh/tests/functional/api/test_versions.py
index 5dd8c251d..23f6c4532 100644
--- a/aodh/tests/functional/api/test_versions.py
+++ b/aodh/tests/functional/api/test_versions.py
@@ -26,7 +26,7 @@ V2_MEDIA_TYPES = [
 ]
 
 V2_HTML_DESCRIPTION = {
-    'href': 'http://docs.openstack.org/',
+    'href': 'https://docs.openstack.org/',
     'rel': 'describedby',
     'type': 'text/html',
 }
diff --git a/doc/source/contributor/webapi/index.rst b/doc/source/contributor/webapi/index.rst
index a3a2c03a5..59c6ee698 100644
--- a/doc/source/contributor/webapi/index.rst
+++ b/doc/source/contributor/webapi/index.rst
@@ -24,7 +24,7 @@ Sample response::
                           "rel": "self"
                       },
                       {
-                          "href": "http://docs.openstack.org/",
+                          "href": "https://docs.openstack.org/",
                           "rel": "describedby",
                           "type": "text/html"
                       }