From 9f7daaa982bccdfdacd0ae8099ab608fa07b2fdb Mon Sep 17 00:00:00 2001 From: VedranZoricic Date: Mon, 25 Aug 2025 14:59:44 +0100 Subject: [PATCH 1/3] 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 90cbad6..0ca327d 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 03d4cc2..4e73265 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 e702c44..c29adbb 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 975c1f9..53753dd 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 87cdee1..5a06962 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 333b1d8..3eb499d 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 0c8aa7d..f7acc32 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 7648d31..c428b19 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 ba9d786..f7252f8 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/3] 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 0ca327d..7ba14c5 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 4e73265..3b734a4 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 c29adbb..89ce5a8 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 53753dd..20bbfb5 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 5a06962..fa56cb7 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 3eb499d..5183629 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 f7acc32..a7c4006 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 c428b19..eb52f7b 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 f7252f8..e89c9ef 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 From 5f677b47d97c7f5f6c9f33f1567f53fc12789010 Mon Sep 17 00:00:00 2001 From: VedranZoricic Date: Tue, 26 Aug 2025 10:01:39 +0100 Subject: [PATCH 3/3] Match latest verion option to the api version --- descriptions/0/api.intercom.io.yaml | 3 +++ descriptions/2.10/api.intercom.io.yaml | 2 -- descriptions/2.11/api.intercom.io.yaml | 1 - descriptions/2.12/api.intercom.io.yaml | 1 - descriptions/2.13/api.intercom.io.yaml | 1 - descriptions/2.14/api.intercom.io.yaml | 4 +++- descriptions/2.7/api.intercom.io.yaml | 5 ----- descriptions/2.8/api.intercom.io.yaml | 4 ---- descriptions/2.9/api.intercom.io.yaml | 3 --- 9 files changed, 6 insertions(+), 18 deletions(-) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 7ba14c5..dc549bd 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -20149,6 +20149,9 @@ components: - '2.9' - '2.10' - '2.11' + - '2.12' + - '2.13' + - '2.14' - Unstable linked_object: title: Linked Object diff --git a/descriptions/2.10/api.intercom.io.yaml b/descriptions/2.10/api.intercom.io.yaml index 3b734a4..cd77533 100644 --- a/descriptions/2.10/api.intercom.io.yaml +++ b/descriptions/2.10/api.intercom.io.yaml @@ -14917,8 +14917,6 @@ components: - '2.8' - '2.9' - '2.10' - - '2.11' - - Unstable linked_object: title: Linked Object type: object diff --git a/descriptions/2.11/api.intercom.io.yaml b/descriptions/2.11/api.intercom.io.yaml index 89ce5a8..823e98e 100644 --- a/descriptions/2.11/api.intercom.io.yaml +++ b/descriptions/2.11/api.intercom.io.yaml @@ -16087,7 +16087,6 @@ components: - '2.9' - '2.10' - '2.11' - - Unstable linked_object: title: Linked Object type: object diff --git a/descriptions/2.12/api.intercom.io.yaml b/descriptions/2.12/api.intercom.io.yaml index 20bbfb5..70c668f 100644 --- a/descriptions/2.12/api.intercom.io.yaml +++ b/descriptions/2.12/api.intercom.io.yaml @@ -16206,7 +16206,6 @@ components: - '2.10' - '2.11' - '2.12' - - Unstable linked_object: title: Linked Object type: object diff --git a/descriptions/2.13/api.intercom.io.yaml b/descriptions/2.13/api.intercom.io.yaml index fa56cb7..90378c5 100644 --- a/descriptions/2.13/api.intercom.io.yaml +++ b/descriptions/2.13/api.intercom.io.yaml @@ -17922,7 +17922,6 @@ components: - '2.11' - '2.12' - '2.13' - - Unstable linked_object: title: Linked Object type: object diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 5183629..a078dac 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -19453,7 +19453,9 @@ components: - '2.9' - '2.10' - '2.11' - - Unstable + - '2.12' + - '2.13' + - '2.14' linked_object: title: Linked Object type: object diff --git a/descriptions/2.7/api.intercom.io.yaml b/descriptions/2.7/api.intercom.io.yaml index a7c4006..3be571b 100644 --- a/descriptions/2.7/api.intercom.io.yaml +++ b/descriptions/2.7/api.intercom.io.yaml @@ -12906,11 +12906,6 @@ components: - '2.5' - '2.6' - '2.7' - - '2.8' - - '2.9' - - '2.10' - - '2.11' - - Unstable merge_contacts_request: description: Merge contact data. type: object diff --git a/descriptions/2.8/api.intercom.io.yaml b/descriptions/2.8/api.intercom.io.yaml index eb52f7b..52e5f9f 100644 --- a/descriptions/2.8/api.intercom.io.yaml +++ b/descriptions/2.8/api.intercom.io.yaml @@ -12931,10 +12931,6 @@ components: - '2.6' - '2.7' - '2.8' - - '2.9' - - '2.10' - - '2.11' - - Unstable merge_contacts_request: description: Merge contact data. type: object diff --git a/descriptions/2.9/api.intercom.io.yaml b/descriptions/2.9/api.intercom.io.yaml index e89c9ef..40faf80 100644 --- a/descriptions/2.9/api.intercom.io.yaml +++ b/descriptions/2.9/api.intercom.io.yaml @@ -14271,9 +14271,6 @@ components: - '2.7' - '2.8' - '2.9' - - '2.10' - - '2.11' - - Unstable merge_contacts_request: description: Merge contact data. type: object