From 18d04098b895338153d2ff056055900f78eb5e4a Mon Sep 17 00:00:00 2001
From: Matthew Pelyhes <matthew.pelyhes@intercom.io>
Date: Thu, 24 Sep 2026 15:04:45 -0500
Subject: [PATCH 1/2] Document help_center target_type for Help Center
 Redirects (Preview)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 descriptions/0/api.intercom.io.yaml | 37 ++++++++++++++++++++++-------
 1 file changed, 28 insertions(+), 9 deletions(-)

diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index a5e8540b..73362fc6 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -3975,7 +3975,7 @@ paths:
                     request_id: 816186b3-3187-4b47-adf8-e201bea32209
                     errors:
                     - code: parameter_invalid
-                      message: target_type must be 'article' or 'collection'
+                      message: target_type must be 'article', 'collection' or 'help_center'
               schema:
                 "$ref": "#/components/schemas/error"
         '401':
@@ -4018,6 +4018,13 @@ paths:
                     errors:
                     - code: data_invalid
                       message: from_url must be an absolute URL within this help center's URL space
+                Help center target mismatch:
+                  value:
+                    type: error.list
+                    request_id: 45d96ec2-641f-4354-b24e-83a85d33bd34
+                    errors:
+                    - code: data_invalid
+                      message: target_id must match the help center for a help_center redirect
               schema:
                 "$ref": "#/components/schemas/error"
         '404':
@@ -4047,6 +4054,12 @@ paths:
                   locale: en
                   target_type: article
                   target_id: '11'
+              help_center_redirect_created:
+                summary: redirect to the help center home page
+                value:
+                  from_url: http://help-center.test/lovelyhelpcenter/en
+                  locale: en-us
+                  target_type: help_center
   "/help_center/help_centers/{help_center_id}/redirects/{id}":
     get:
       summary: Retrieve a redirect
@@ -30514,8 +30527,9 @@ components:
       x-tags:
       - Help Center
       description: |
-        A redirect maps a source URL (`from_url`) to an article or collection within a
-        help center, so that links to old or external URLs resolve to live content.
+        A redirect maps a source URL (`from_url`) to an article, a collection or the
+        home page of a help center, so that links to old or external URLs resolve to
+        live content.
       properties:
         id:
           type: string
@@ -30545,15 +30559,17 @@ components:
           example: '7'
         target_type:
           type: string
-          description: The type of the redirect target.
+          description: The type of the redirect target. `help_center` targets the
+            help center's home page.
           enum:
           - article
           - collection
+          - help_center
           example: article
         target_id:
           type: string
-          description: The unique identifier of the target article or collection. For
-            article targets this is the Article ID.
+          description: The unique identifier of the target article, collection or help
+            center. For article targets this is the Article ID.
           example: '11'
         created_at:
           type: integer
@@ -30602,21 +30618,24 @@ components:
           example: en
         target_type:
           type: string
-          description: The type of the redirect target.
+          description: The type of the redirect target. `help_center` targets the
+            help center's home page.
           enum:
           - article
           - collection
+          - help_center
           example: article
         target_id:
           type: string
           description: The unique identifier of the target article or collection. The
-            target must be a member of the help center.
+            target must be a member of the help center. Required unless `target_type`
+            is `help_center`, where it defaults to the help center in the path and
+            must match it if provided.
           example: '11'
       required:
       - from_url
       - locale
       - target_type
-      - target_id
     deleted_help_center_redirect_object:
       title: Deleted Help Center Redirect Object
       type: object

From 516b012fdf5059fdfd4f8605f46052824fae6d91 Mon Sep 17 00:00:00 2001
From: Matthew Pelyhes <matthew.pelyhes@intercom.io>
Date: Fri, 25 Sep 2026 16:19:26 -0500
Subject: [PATCH 2/2] Describe help center ids in the redirect target_id field

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 descriptions/0/api.intercom.io.yaml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index 73362fc6..de4c7fa9 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -30627,10 +30627,10 @@ components:
           example: article
         target_id:
           type: string
-          description: The unique identifier of the target article or collection. The
-            target must be a member of the help center. Required unless `target_type`
-            is `help_center`, where it defaults to the help center in the path and
-            must match it if provided.
+          description: The unique identifier of the target article, collection or help
+            center. The target must be a member of the help center. Required unless
+            `target_type` is `help_center`, where it defaults to the help center in the
+            path and must match it if provided.
           example: '11'
       required:
       - from_url