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 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/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 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 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 7ba14c5d..dc549bd2 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 3b734a46..cd775339 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 89ce5a8d..823e98e3 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 20bbfb59..70c668f0 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 fa56cb7c..90378c53 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 51836292..a078dac6 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 a7c4006b..3be571b2 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 eb52f7b6..52e5f9f4 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 e89c9ef6..40faf805 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