From 263e3bdb7225fdb2e618abc7da52690e8665e157 Mon Sep 17 00:00:00 2001
From: dq <daniel.qian@intercom.io>
Date: Mon, 29 Jun 2026 10:15:07 +0100
Subject: [PATCH] docs: type listAwayStatusReasons response as list wrapper

GET /away_status_reasons returns Intercom's standard list envelope
{ "type": "list", "data": [...] }, but the 200 response was modeled as a
bare array of away_status_reason objects. Add an away_status_reason_list
component (matching the tag_list/brand_list convention) and point the 200
response at it, across the versions that expose the endpoint: 2.14, 2.15,
and 0 (Preview).

Verified against the monolith: Api::V3::AwayStatusReasonsController#index
renders via AwayStatusReasonListResponse, which emits { type: "list", data }.
fern check reports no new errors or warnings vs main.

Refs intercom/intercom-node#520, FER-11398, intercom/Intercom-OpenAPI#558.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 descriptions/0/api.intercom.io.yaml    | 20 +++++++++++++++++---
 descriptions/2.14/api.intercom.io.yaml | 20 +++++++++++++++++---
 descriptions/2.15/api.intercom.io.yaml | 20 +++++++++++++++++---
 3 files changed, 51 insertions(+), 9 deletions(-)

diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index 60e8305..15be36e 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -2432,9 +2432,7 @@ paths:
           content:
             application/json:
               schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/away_status_reason"
+                "$ref": "#/components/schemas/away_status_reason_list"
         '401':
           "$ref": "#/components/responses/Unauthorized"
   "/audiences":
@@ -26359,6 +26357,22 @@ components:
           type: integer
           description: "The Unix timestamp when the status reason was last updated"
           example: 1734537243
+    away_status_reason_list:
+      title: Away Status Reasons
+      type: object
+      description: A list of away status reasons.
+      properties:
+        type:
+          type: string
+          description: The type of the object
+          enum:
+          - list
+          example: list
+        data:
+          type: array
+          description: A list of away status reason objects.
+          items:
+            "$ref": "#/components/schemas/away_status_reason"
     change_ticket_type_request:
       title: Change Ticket Type Request
       description: You can change the type of a Ticket
diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml
index 7c94078..1dcdf42 100644
--- a/descriptions/2.14/api.intercom.io.yaml
+++ b/descriptions/2.14/api.intercom.io.yaml
@@ -1508,9 +1508,7 @@ paths:
           content:
             application/json:
               schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/away_status_reason"
+                "$ref": "#/components/schemas/away_status_reason_list"
         '401':
           "$ref": "#/components/responses/Unauthorized"
   "/export/reporting_data/enqueue":
@@ -15771,6 +15769,22 @@ components:
           type: integer
           description: "The Unix timestamp when the status reason was last updated"
           example: 1734537243
+    away_status_reason_list:
+      title: Away Status Reasons
+      type: object
+      description: A list of away status reasons.
+      properties:
+        type:
+          type: string
+          description: The type of the object
+          enum:
+          - list
+          example: list
+        data:
+          type: array
+          description: A list of away status reason objects.
+          items:
+            "$ref": "#/components/schemas/away_status_reason"
     close_conversation_request:
       title: Close Conversation Request
       type: object
diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml
index 3fca175..bfeac53 100644
--- a/descriptions/2.15/api.intercom.io.yaml
+++ b/descriptions/2.15/api.intercom.io.yaml
@@ -1514,9 +1514,7 @@ paths:
           content:
             application/json:
               schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/away_status_reason"
+                "$ref": "#/components/schemas/away_status_reason_list"
         '401':
           "$ref": "#/components/responses/Unauthorized"
   "/export/reporting_data/enqueue":
@@ -16511,6 +16509,22 @@ components:
           type: integer
           description: "The Unix timestamp when the status reason was last updated"
           example: 1734537243
+    away_status_reason_list:
+      title: Away Status Reasons
+      type: object
+      description: A list of away status reasons.
+      properties:
+        type:
+          type: string
+          description: The type of the object
+          enum:
+          - list
+          example: list
+        data:
+          type: array
+          description: A list of away status reason objects.
+          items:
+            "$ref": "#/components/schemas/away_status_reason"
     close_conversation_request:
       title: Close Conversation Request
       type: object