diff --git a/api-ref/source/v2/samples/schemas-image-show-response.json b/api-ref/source/v2/samples/schemas-image-show-response.json
index 71cbe2dd6b..838254968f 100644
--- a/api-ref/source/v2/samples/schemas-image-show-response.json
+++ b/api-ref/source/v2/samples/schemas-image-show-response.json
@@ -19,7 +19,7 @@
     "name": "image",
     "properties": {
         "architecture": {
-            "description": "Operating system architecture as specified in http://docs.openstack.org/trunk/openstack-compute/admin/content/adding-images.html",
+            "description": "Operating system architecture as specified in https://docs.openstack.org/cli-reference/glance-property-keys.html",
             "is_base": false,
             "type": "string"
         },
@@ -141,7 +141,7 @@
             ]
         },
         "os_distro": {
-            "description": "Common name of operating system distribution as specified in http://docs.openstack.org/trunk/openstack-compute/admin/content/adding-images.html",
+            "description": "Common name of operating system distribution as specified in https://docs.openstack.org/cli-reference/glance-property-keys.html",
             "is_base": false,
             "type": "string"
         },
diff --git a/api-ref/source/v2/samples/schemas-images-list-response.json b/api-ref/source/v2/samples/schemas-images-list-response.json
index b69c51e959..6f54495716 100644
--- a/api-ref/source/v2/samples/schemas-images-list-response.json
+++ b/api-ref/source/v2/samples/schemas-images-list-response.json
@@ -40,7 +40,7 @@
                 "name": "image",
                 "properties": {
                     "architecture": {
-                        "description": "Operating system architecture as specified in http://docs.openstack.org/trunk/openstack-compute/admin/content/adding-images.html",
+                        "description": "Operating system architecture as specified in https://docs.openstack.org/cli-reference/glance-property-keys.html",
                         "is_base": false,
                         "type": "string"
                     },
@@ -162,7 +162,7 @@
                         ]
                     },
                     "os_distro": {
-                        "description": "Common name of operating system distribution as specified in http://docs.openstack.org/trunk/openstack-compute/admin/content/adding-images.html",
+                        "description": "Common name of operating system distribution as specified in https://docs.openstack.org/cli-reference/glance-property-keys.html",
                         "is_base": false,
                         "type": "string"
                     },
diff --git a/etc/schema-image.json b/etc/schema-image.json
index 69c2f85dc6..1b7ca5f19a 100644
--- a/etc/schema-image.json
+++ b/etc/schema-image.json
@@ -14,11 +14,11 @@
         "description": "Metadata which can be used to record which instance this image is associated with. (Informational only, does not create an instance snapshot.)"
     },
     "architecture": {
-        "description": "Operating system architecture as specified in http://docs.openstack.org/trunk/openstack-compute/admin/content/adding-images.html",
+        "description": "Operating system architecture as specified in https://docs.openstack.org/cli-reference/glance-property-keys.html",
         "type": "string"
     },
     "os_distro": {
-        "description": "Common name of operating system distribution as specified in http://docs.openstack.org/trunk/openstack-compute/admin/content/adding-images.html",
+        "description": "Common name of operating system distribution as specified in https://docs.openstack.org/cli-reference/glance-property-keys.html",
         "type": "string"
     },
     "os_version": {