From 9f7daaa982bccdfdacd0ae8099ab608fa07b2fdb Mon Sep 17 00:00:00 2001 From: VedranZoricic Date: Mon, 25 Aug 2025 14:59:44 +0100 Subject: [PATCH 1/2] Add url_prefix and custom_domain fields to Help Center schema MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Add two new fields to the help_center schema across all API versions: - url_prefix: The URL path prefix for the help center (e.g., "/help") - custom_domain: Custom domain configured for the help center (nullable) These fields are added to all API versions (0, 2.7-2.14) as Help Center endpoints are not version-gated, making these fields available across all versions. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- descriptions/0/api.intercom.io.yaml | 9 +++++++++ descriptions/2.10/api.intercom.io.yaml | 9 +++++++++ descriptions/2.11/api.intercom.io.yaml | 9 +++++++++ descriptions/2.12/api.intercom.io.yaml | 9 +++++++++ descriptions/2.13/api.intercom.io.yaml | 9 +++++++++ descriptions/2.14/api.intercom.io.yaml | 9 +++++++++ descriptions/2.7/api.intercom.io.yaml | 9 +++++++++ descriptions/2.8/api.intercom.io.yaml | 9 +++++++++ descriptions/2.9/api.intercom.io.yaml | 9 +++++++++ 9 files changed, 81 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 90cbad6b..0ca327db 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -20055,6 +20055,15 @@ components: type: string description: The display name of the Help Center only seen by teammates. example: Intercom Help Center + url_prefix: + type: string + description: The URL path prefix for the help center + example: "/help" + custom_domain: + type: string + nullable: true + description: Custom domain configured for the help center + example: "help.company.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.10/api.intercom.io.yaml b/descriptions/2.10/api.intercom.io.yaml index 03d4cc2b..4e73265f 100644 --- a/descriptions/2.10/api.intercom.io.yaml +++ b/descriptions/2.10/api.intercom.io.yaml @@ -14867,6 +14867,15 @@ components: type: string description: The display name of the Help Center only seen by teammates. example: Intercom Help Center + url_prefix: + type: string + description: The URL path prefix for the help center + example: "/help" + custom_domain: + type: string + nullable: true + description: Custom domain configured for the help center + example: "help.company.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.11/api.intercom.io.yaml b/descriptions/2.11/api.intercom.io.yaml index e702c442..c29adbb3 100644 --- a/descriptions/2.11/api.intercom.io.yaml +++ b/descriptions/2.11/api.intercom.io.yaml @@ -15884,6 +15884,15 @@ components: type: string description: The display name of the Help Center only seen by teammates. example: Intercom Help Center + url_prefix: + type: string + description: The URL path prefix for the help center + example: "/help" + custom_domain: + type: string + nullable: true + description: Custom domain configured for the help center + example: "help.company.com" required: - id - workspace_id diff --git a/descriptions/2.12/api.intercom.io.yaml b/descriptions/2.12/api.intercom.io.yaml index 975c1f9e..53753dd6 100644 --- a/descriptions/2.12/api.intercom.io.yaml +++ b/descriptions/2.12/api.intercom.io.yaml @@ -16154,6 +16154,15 @@ components: type: string description: The display name of the Help Center only seen by teammates. example: Intercom Help Center + url_prefix: + type: string + description: The URL path prefix for the help center + example: "/help" + custom_domain: + type: string + nullable: true + description: Custom domain configured for the help center + example: "help.company.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index 87cdee1c..5a069621 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -17869,6 +17869,15 @@ components: type: string description: The display name of the Help Center only seen by teammates. example: Intercom Help Center + url_prefix: + type: string + description: The URL path prefix for the help center + example: "/help" + custom_domain: + type: string + nullable: true + description: Custom domain configured for the help center + example: "help.company.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 333b1d88..3eb499d2 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -19359,6 +19359,15 @@ components: type: string description: The display name of the Help Center only seen by teammates. example: Intercom Help Center + url_prefix: + type: string + description: The URL path prefix for the help center + example: "/help" + custom_domain: + type: string + nullable: true + description: Custom domain configured for the help center + example: "help.company.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.7/api.intercom.io.yaml b/descriptions/2.7/api.intercom.io.yaml index 0c8aa7d4..f7acc324 100644 --- a/descriptions/2.7/api.intercom.io.yaml +++ b/descriptions/2.7/api.intercom.io.yaml @@ -12859,6 +12859,15 @@ components: type: string description: The display name of the Help Center only seen by teammates. example: Intercom Help Center + url_prefix: + type: string + description: The URL path prefix for the help center + example: "/help" + custom_domain: + type: string + nullable: true + description: Custom domain configured for the help center + example: "help.company.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.8/api.intercom.io.yaml b/descriptions/2.8/api.intercom.io.yaml index 7648d315..c428b191 100644 --- a/descriptions/2.8/api.intercom.io.yaml +++ b/descriptions/2.8/api.intercom.io.yaml @@ -12883,6 +12883,15 @@ components: type: string description: The display name of the Help Center only seen by teammates. example: Intercom Help Center + url_prefix: + type: string + description: The URL path prefix for the help center + example: "/help" + custom_domain: + type: string + nullable: true + description: Custom domain configured for the help center + example: "help.company.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.9/api.intercom.io.yaml b/descriptions/2.9/api.intercom.io.yaml index ba9d786e..f7252f8e 100644 --- a/descriptions/2.9/api.intercom.io.yaml +++ b/descriptions/2.9/api.intercom.io.yaml @@ -14222,6 +14222,15 @@ components: type: string description: The display name of the Help Center only seen by teammates. example: Intercom Help Center + url_prefix: + type: string + description: The URL path prefix for the help center + example: "/help" + custom_domain: + type: string + nullable: true + description: Custom domain configured for the help center + example: "help.company.com" help_center_list: title: Help Centers type: object From b9b468c57a59021d20302149aaea0b4aba4f00ae Mon Sep 17 00:00:00 2001 From: VedranZoricic Date: Mon, 25 Aug 2025 19:26:32 +0100 Subject: [PATCH 2/2] Fix Help Center URL examples in API documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Updated url_prefix and custom_domain examples to use correct format: - url_prefix: "https://intercom.help/mycompany" (was "/help") - custom_domain: "help.mycompany.com" (was "help.company.com") 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude --- descriptions/0/api.intercom.io.yaml | 4 ++-- descriptions/2.10/api.intercom.io.yaml | 4 ++-- descriptions/2.11/api.intercom.io.yaml | 4 ++-- descriptions/2.12/api.intercom.io.yaml | 4 ++-- descriptions/2.13/api.intercom.io.yaml | 4 ++-- descriptions/2.14/api.intercom.io.yaml | 4 ++-- descriptions/2.7/api.intercom.io.yaml | 4 ++-- descriptions/2.8/api.intercom.io.yaml | 4 ++-- descriptions/2.9/api.intercom.io.yaml | 4 ++-- 9 files changed, 18 insertions(+), 18 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 0ca327db..7ba14c5d 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -20058,12 +20058,12 @@ components: url_prefix: type: string description: The URL path prefix for the help center - example: "/help" + example: "https://intercom.help/mycompany" custom_domain: type: string nullable: true description: Custom domain configured for the help center - example: "help.company.com" + example: "help.mycompany.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.10/api.intercom.io.yaml b/descriptions/2.10/api.intercom.io.yaml index 4e73265f..3b734a46 100644 --- a/descriptions/2.10/api.intercom.io.yaml +++ b/descriptions/2.10/api.intercom.io.yaml @@ -14870,12 +14870,12 @@ components: url_prefix: type: string description: The URL path prefix for the help center - example: "/help" + example: "https://intercom.help/mycompany" custom_domain: type: string nullable: true description: Custom domain configured for the help center - example: "help.company.com" + example: "help.mycompany.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.11/api.intercom.io.yaml b/descriptions/2.11/api.intercom.io.yaml index c29adbb3..89ce5a8d 100644 --- a/descriptions/2.11/api.intercom.io.yaml +++ b/descriptions/2.11/api.intercom.io.yaml @@ -15887,12 +15887,12 @@ components: url_prefix: type: string description: The URL path prefix for the help center - example: "/help" + example: "https://intercom.help/mycompany" custom_domain: type: string nullable: true description: Custom domain configured for the help center - example: "help.company.com" + example: "help.mycompany.com" required: - id - workspace_id diff --git a/descriptions/2.12/api.intercom.io.yaml b/descriptions/2.12/api.intercom.io.yaml index 53753dd6..20bbfb59 100644 --- a/descriptions/2.12/api.intercom.io.yaml +++ b/descriptions/2.12/api.intercom.io.yaml @@ -16157,12 +16157,12 @@ components: url_prefix: type: string description: The URL path prefix for the help center - example: "/help" + example: "https://intercom.help/mycompany" custom_domain: type: string nullable: true description: Custom domain configured for the help center - example: "help.company.com" + example: "help.mycompany.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index 5a069621..fa56cb7c 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -17872,12 +17872,12 @@ components: url_prefix: type: string description: The URL path prefix for the help center - example: "/help" + example: "https://intercom.help/mycompany" custom_domain: type: string nullable: true description: Custom domain configured for the help center - example: "help.company.com" + example: "help.mycompany.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 3eb499d2..51836292 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -19362,12 +19362,12 @@ components: url_prefix: type: string description: The URL path prefix for the help center - example: "/help" + example: "https://intercom.help/mycompany" custom_domain: type: string nullable: true description: Custom domain configured for the help center - example: "help.company.com" + example: "help.mycompany.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.7/api.intercom.io.yaml b/descriptions/2.7/api.intercom.io.yaml index f7acc324..a7c4006b 100644 --- a/descriptions/2.7/api.intercom.io.yaml +++ b/descriptions/2.7/api.intercom.io.yaml @@ -12862,12 +12862,12 @@ components: url_prefix: type: string description: The URL path prefix for the help center - example: "/help" + example: "https://intercom.help/mycompany" custom_domain: type: string nullable: true description: Custom domain configured for the help center - example: "help.company.com" + example: "help.mycompany.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.8/api.intercom.io.yaml b/descriptions/2.8/api.intercom.io.yaml index c428b191..eb52f7b6 100644 --- a/descriptions/2.8/api.intercom.io.yaml +++ b/descriptions/2.8/api.intercom.io.yaml @@ -12886,12 +12886,12 @@ components: url_prefix: type: string description: The URL path prefix for the help center - example: "/help" + example: "https://intercom.help/mycompany" custom_domain: type: string nullable: true description: Custom domain configured for the help center - example: "help.company.com" + example: "help.mycompany.com" help_center_list: title: Help Centers type: object diff --git a/descriptions/2.9/api.intercom.io.yaml b/descriptions/2.9/api.intercom.io.yaml index f7252f8e..e89c9ef6 100644 --- a/descriptions/2.9/api.intercom.io.yaml +++ b/descriptions/2.9/api.intercom.io.yaml @@ -14225,12 +14225,12 @@ components: url_prefix: type: string description: The URL path prefix for the help center - example: "/help" + example: "https://intercom.help/mycompany" custom_domain: type: string nullable: true description: Custom domain configured for the help center - example: "help.company.com" + example: "help.mycompany.com" help_center_list: title: Help Centers type: object