From ed3e4cfcfbe5a795822165212d2a02a5beaed601 Mon Sep 17 00:00:00 2001
From: Ivan Branimir Skoric <58559012+ib-skoric@users.noreply.github.com>
Date: Tue, 14 Apr 2026 11:28:12 +0100
Subject: [PATCH] Remove parent_id and parent_type from article responses in
 Preview spec

Reflects intercom/intercom#491162 which deprecates these fields from article
API responses. The denormalized parent_id/parent_type fields are frequently
out of sync; consumers should use parent_ids instead.

Changes:
- Remove parent_id and parent_type from article_list_item schema
- Remove parent_id and parent_type from all article response examples
  (list, create, retrieve, update, search)
- Request schemas unchanged (still accept parent_id/parent_type as input)
- Stable versions (2.7-2.15) unchanged
- Collection parent_id fields unchanged (different resource)
---
 descriptions/0/api.intercom.io.yaml | 21 ---------------------
 1 file changed, 21 deletions(-)

diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index 7ef512d..ca895a5 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -1222,8 +1222,6 @@ paths:
                     - id: '39'
                       type: article
                       workspace_id: this_is_an_id64_that_should_be_at_least_4
-                      parent_id: 143
-                      parent_type: collection
                       parent_ids: []
                       tags:
                         type: tag.list
@@ -1277,8 +1275,6 @@ paths:
                     id: '42'
                     type: article
                     workspace_id: this_is_an_id68_that_should_be_at_least_4
-                    parent_id: 145
-                    parent_type: collection
                     parent_ids: []
                     statistics:
                       type: article_statistics
@@ -1391,8 +1387,6 @@ paths:
                     id: '45'
                     type: article
                     workspace_id: this_is_an_id74_that_should_be_at_least_4
-                    parent_id: 148
-                    parent_type: collection
                     parent_ids: []
                     statistics:
                       type: article_statistics
@@ -1476,8 +1470,6 @@ paths:
                     id: '48'
                     type: article
                     workspace_id: this_is_an_id80_that_should_be_at_least_4
-                    parent_id: 151
-                    parent_type: collection
                     parent_ids: []
                     statistics:
                       type: article_statistics
@@ -1660,8 +1652,6 @@ paths:
                       - id: '55'
                         type: article
                         workspace_id: this_is_an_id92_that_should_be_at_least_4
-                        parent_id:
-                        parent_type:
                         parent_ids: []
                         tags:
                           type: tag.list
@@ -19024,12 +19014,6 @@ components:
           description: The URL of the article. For multilingual articles, this will
             be the URL of the default language's content.
           example: http://intercom.test/help/en/articles/3-default-language
-        parent_id:
-          type: integer
-          nullable: true
-          description: The id of the article's parent collection or section. An article
-            without this field stands alone.
-          example: '125685'
         parent_ids:
           type: array
           description: The ids of the article's parent collections or sections. An
@@ -19039,11 +19023,6 @@ components:
           example:
           - 18
           - 19
-        parent_type:
-          type: string
-          nullable: true
-          description: The type of parent, which can either be a `collection` or `section`.
-          example: collection
         default_locale:
           type: string
           description: The default locale of the help center. This field is only returned