diff --git a/openapi.json b/openapi.json
index a29a6dfe..18d56a2f 100755
--- a/openapi.json
+++ b/openapi.json
@@ -8891,7 +8891,7 @@
         ],
         "externalDocs": {
           "description": "Merchant documentation",
-          "url": "https://developer.sumup.com/tools/models/merchant"
+          "url": "https://developer.sumup.com/tools/glossary/merchant"
         },
         "title": "Merchant"
       },
@@ -8943,7 +8943,7 @@
         },
         "externalDocs": {
           "description": "Company documentation",
-          "url": "https://developer.sumup.com/tools/models/merchant#company"
+          "url": "https://developer.sumup.com/tools/glossary/merchant#company"
         }
       },
       "Meta": {
@@ -9088,7 +9088,7 @@
         ],
         "externalDocs": {
           "description": "The country SDK documentation for legal types.",
-          "url": "https://developer.sumup.com/tools/models/merchant#legal-types"
+          "url": "https://developer.sumup.com/tools/glossary/merchant#legal-types"
         },
         "maxLength": 64,
         "minLength": 4
@@ -9127,7 +9127,7 @@
         ],
         "externalDocs": {
           "description": "Company identifier documentation",
-          "url": "https://developer.sumup.com/tools/models/merchant#company-identifiers"
+          "url": "https://developer.sumup.com/tools/glossary/merchant#company-identifiers"
         },
         "required": [
           "ref",
@@ -9261,7 +9261,7 @@
         },
         "externalDocs": {
           "description": "Person documentation",
-          "url": "https://developer.sumup.com/tools/models/merchant#persons"
+          "url": "https://developer.sumup.com/tools/glossary/merchant#persons"
         },
         "required": [
           "id"
diff --git a/openapi.yaml b/openapi.yaml
index 6a98f258..a18a6425 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -6307,7 +6307,7 @@ components:
         - $ref: '#/components/schemas/Timestamps'
       externalDocs:
         description: Merchant documentation
-        url: 'https://developer.sumup.com/tools/models/merchant'
+        url: 'https://developer.sumup.com/tools/glossary/merchant'
       title: Merchant
     Company:
       description: |
@@ -6349,7 +6349,7 @@ components:
           $ref: '#/components/schemas/Attributes'
       externalDocs:
         description: Company documentation
-        url: 'https://developer.sumup.com/tools/models/merchant#company'
+        url: 'https://developer.sumup.com/tools/glossary/merchant#company'
     Meta:
       description: |-
         A set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
@@ -6476,7 +6476,7 @@ components:
         - bg.private_limited_company
       externalDocs:
         description: The country SDK documentation for legal types.
-        url: 'https://developer.sumup.com/tools/models/merchant#legal-types'
+        url: 'https://developer.sumup.com/tools/glossary/merchant#legal-types'
       maxLength: 64
       minLength: 4
     CompanyIdentifiers:
@@ -6506,7 +6506,7 @@ components:
           value: HRB 123456
       externalDocs:
         description: Company identifier documentation
-        url: 'https://developer.sumup.com/tools/models/merchant#company-identifiers'
+        url: 'https://developer.sumup.com/tools/glossary/merchant#company-identifiers'
       required:
         - ref
         - value
@@ -6624,7 +6624,7 @@ components:
           $ref: '#/components/schemas/ChangeStatus'
       externalDocs:
         description: Person documentation
-        url: 'https://developer.sumup.com/tools/models/merchant#persons'
+        url: 'https://developer.sumup.com/tools/glossary/merchant#persons'
       required:
         - id
     ClassicMerchantIdentifiers: