From 0b40ef3ea85d2bf49938eb6bd975be8475fdef51 Mon Sep 17 00:00:00 2001
From: Ivan Branimir Skoric <58559012+ib-skoric@users.noreply.github.com>
Date: Fri, 22 May 2026 11:58:10 +0100
Subject: [PATCH] Add ai_*_availability boolean fields to internal_article
 schema (Preview only)

Adds ai_chatbot_availability, ai_copilot_availability, and
ai_sales_agent_availability boolean fields to internal_article_list_item
schema. Available in Preview API only (version-gated). Updates inline
response examples for list, create, retrieve, and update endpoints.

Sourced from intercom/intercom#512233.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
---
 descriptions/0/api.intercom.io.yaml | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index bd352a1..9008a1c 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -2619,6 +2619,9 @@ paths:
                       owner_id: 991266252
                       author_id: 991266252
                       locale: en
+                      ai_chatbot_availability: true
+                      ai_copilot_availability: true
+                      ai_sales_agent_availability: true
               schema:
                 "$ref": "#/components/schemas/internal_article_list"
         '401':
@@ -2661,6 +2664,9 @@ paths:
                     owner_id: 991266252
                     author_id: 991266252
                     locale: en
+                    ai_chatbot_availability: true
+                    ai_copilot_availability: true
+                    ai_sales_agent_availability: true
               schema:
                 "$ref": "#/components/schemas/internal_article"
         '400':
@@ -2745,6 +2751,9 @@ paths:
                     owner_id: 991266252
                     author_id: 991266252
                     locale: en
+                    ai_chatbot_availability: true
+                    ai_copilot_availability: true
+                    ai_sales_agent_availability: true
               schema:
                 "$ref": "#/components/schemas/internal_article"
         '404':
@@ -2808,6 +2817,9 @@ paths:
                     owner_id: 991266252
                     author_id: 991266252
                     locale: en
+                    ai_chatbot_availability: true
+                    ai_copilot_availability: true
+                    ai_sales_agent_availability: true
               schema:
                 "$ref": "#/components/schemas/internal_article"
         '404':
@@ -20360,6 +20372,18 @@ components:
           nullable: true
           description: The ID of the folder this article belongs to, or null if not in a folder.
           example: 6
+        ai_chatbot_availability:
+          type: boolean
+          description: Whether the internal article is available for AI Chatbot.
+          example: true
+        ai_copilot_availability:
+          type: boolean
+          description: Whether the internal article is available for AI Copilot.
+          example: true
+        ai_sales_agent_availability:
+          type: boolean
+          description: Whether the internal article is available for AI Sales Agent.
+          example: true
     article_search_highlights:
       title: Article Search Highlights
       type: object