Improve help center response and brand description (#301)

* Add url_prefix and custom_domain fields to help center API response examples

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

* Add default brand id explaination

---------

Co-authored-by: Claude <[email protected]>

Author: VedranZoricic

descriptions/0/api.intercom.io.yaml

@@ -2163,6 +2163,8 @@ paths:
                     identifier: help-center-1
                     website_turned_on: false
                     display_name: Intercom Help Center
+                    url_prefix: https://help.mycompany.com
+                    custom_domain: help.mycompany.com
               schema:
                 "$ref": "#/components/schemas/help_center"
         '404':
@@ -14655,7 +14657,9 @@ paths:
       tags:
         - Brands
       operationId: listBrands
-      description: Retrieves all brands for the workspace, including the default brand
+      description: |
+        Retrieves all brands for the workspace, including the default brand.
+        The default brand id always matches the workspace 
       parameters:
         - name: Intercom-Version
           in: header
@@ -14674,7 +14678,7 @@ paths:
                     type: list
                     data:
                       - type: brand
-                        id: "2"
+                        id: "tlkp1d91"
                         name: "Default Brand"
                         is_default: true
                         created_at: 1673778600
@@ -20390,7 +20394,7 @@ components:
         url_prefix:
           type: string
           description: The URL path prefix for the help center
-          example: "https://intercom.help/mycompany"
+          example: "https://help.mycompany.com"
         custom_domain:
           type: string
           nullable: true

descriptions/2.10/api.intercom.io.yaml

@@ -1235,6 +1235,8 @@ paths:
                     identifier: help-center-1
                     website_turned_on: false
                     display_name: Intercom Help Center
+                    url_prefix: https://help.mycompany.com
+                    custom_domain: help.mycompany.com
               schema:
                 "$ref": "#/components/schemas/help_center"
         '404':
@@ -14870,7 +14872,7 @@ components:
         url_prefix:
           type: string
           description: The URL path prefix for the help center
-          example: "https://intercom.help/mycompany"
+          example: "https://help.mycompany.com"
         custom_domain:
           type: string
           nullable: true

descriptions/2.11/api.intercom.io.yaml

@@ -1263,6 +1263,8 @@ paths:
                     identifier: help-center-1
                     website_turned_on: false
                     display_name: Intercom Help Center
+                    url_prefix: https://help.mycompany.com
+                    custom_domain: help.mycompany.com
               schema:
                 "$ref": "#/components/schemas/help_center"
         '404':
@@ -15887,7 +15889,7 @@ components:
         url_prefix:
           type: string
           description: The URL path prefix for the help center
-          example: "https://intercom.help/mycompany"
+          example: "https://help.mycompany.com"
         custom_domain:
           type: string
           nullable: true

descriptions/2.12/api.intercom.io.yaml

@@ -1817,6 +1817,8 @@ paths:
                     identifier: help-center-1
                     website_turned_on: false
                     display_name: Intercom Help Center
+                    url_prefix: https://help.mycompany.com
+                    custom_domain: help.mycompany.com
               schema:
                 "$ref": "#/components/schemas/help_center"
         '404':
@@ -16157,7 +16159,7 @@ components:
         url_prefix:
           type: string
           description: The URL path prefix for the help center
-          example: "https://intercom.help/mycompany"
+          example: "https://help.mycompany.com"
         custom_domain:
           type: string
           nullable: true

descriptions/2.13/api.intercom.io.yaml

@@ -1847,6 +1847,8 @@ paths:
                     identifier: help-center-1
                     website_turned_on: false
                     display_name: Intercom Help Center
+                    url_prefix: https://help.mycompany.com
+                    custom_domain: help.mycompany.com
               schema:
                 "$ref": "#/components/schemas/help_center"
         '404':
@@ -17872,7 +17874,7 @@ components:
         url_prefix:
           type: string
           description: The URL path prefix for the help center
-          example: "https://intercom.help/mycompany"
+          example: "https://help.mycompany.com"
         custom_domain:
           type: string
           nullable: true

descriptions/2.14/api.intercom.io.yaml

@@ -2163,6 +2163,8 @@ paths:
                     identifier: help-center-1
                     website_turned_on: false
                     display_name: Intercom Help Center
+                    url_prefix: https://help.mycompany.com
+                    custom_domain: help.mycompany.com
               schema:
                 "$ref": "#/components/schemas/help_center"
         '404':
@@ -19362,7 +19364,7 @@ components:
         url_prefix:
           type: string
           description: The URL path prefix for the help center
-          example: "https://intercom.help/mycompany"
+          example: "https://help.mycompany.com"
         custom_domain:
           type: string
           nullable: true

descriptions/2.7/api.intercom.io.yaml

@@ -1134,6 +1134,8 @@ paths:
                     identifier: help-center-1
                     website_turned_on: false
                     display_name: Intercom Help Center
+                    url_prefix: https://help.mycompany.com
+                    custom_domain: help.mycompany.com
               schema:
                 "$ref": "#/components/schemas/help_center"
         '404':
@@ -12862,7 +12864,7 @@ components:
         url_prefix:
           type: string
           description: The URL path prefix for the help center
-          example: "https://intercom.help/mycompany"
+          example: "https://help.mycompany.com"
         custom_domain:
           type: string
           nullable: true

descriptions/2.8/api.intercom.io.yaml

@@ -1134,6 +1134,8 @@ paths:
                     identifier: help-center-1
                     website_turned_on: false
                     display_name: Intercom Help Center
+                    url_prefix: https://help.mycompany.com
+                    custom_domain: help.mycompany.com
               schema:
                 "$ref": "#/components/schemas/help_center"
         '404':
@@ -12886,7 +12888,7 @@ components:
         url_prefix:
           type: string
           description: The URL path prefix for the help center
-          example: "https://intercom.help/mycompany"
+          example: "https://help.mycompany.com"
         custom_domain:
           type: string
           nullable: true

descriptions/2.9/api.intercom.io.yaml

@@ -1134,6 +1134,8 @@ paths:
                     identifier: help-center-1
                     website_turned_on: false
                     display_name: Intercom Help Center
+                    url_prefix: https://help.mycompany.com
+                    custom_domain: help.mycompany.com
               schema:
                 "$ref": "#/components/schemas/help_center"
         '404':
@@ -14225,7 +14227,7 @@ components:
         url_prefix:
           type: string
           description: The URL path prefix for the help center
-          example: "https://intercom.help/mycompany"
+          example: "https://help.mycompany.com"
         custom_domain:
           type: string
           nullable: true