diff --git a/api-ref/source/samples/api-v1-root-response.json b/api-ref/source/samples/api-v1-root-response.json
index 7b691bb7c0..0a0a11a2f5 100644
--- a/api-ref/source/samples/api-v1-root-response.json
+++ b/api-ref/source/samples/api-v1-root-response.json
@@ -36,7 +36,7 @@
       "rel": "self"
     },
     {
-      "href": "http://docs.openstack.org/developer/ironic/dev/api-spec-v1.html",
+      "href": "https://docs.openstack.org/developer/ironic/dev/webapi.html",
       "rel": "describedby",
       "type": "text/html"
     }
diff --git a/ironic/api/controllers/v1/__init__.py b/ironic/api/controllers/v1/__init__.py
index e6c23a1c7a..f3326d2db6 100644
--- a/ironic/api/controllers/v1/__init__.py
+++ b/ironic/api/controllers/v1/__init__.py
@@ -97,9 +97,9 @@ class V1(base.APIBase):
         v1.links = [link.Link.make_link('self', pecan.request.public_url,
                                         'v1', '', bookmark=True),
                     link.Link.make_link('describedby',
-                                        'http://docs.openstack.org',
+                                        'https://docs.openstack.org',
                                         'developer/ironic/dev',
-                                        'api-spec-v1.html',
+                                        'webapi.html',
                                         bookmark=True, type='text/html')
                     ]
         v1.media_types = [MediaType('application/json',