From 9f270c201e488e1bbe5648c8c6e67d43197e6c03 Mon Sep 17 00:00:00 2001
From: Ivan Branimir Skoric <58559012+ib-skoric@users.noreply.github.com>
Date: Fri, 15 May 2026 18:00:48 +0100
Subject: [PATCH] Add AI agent availability boolean fields to article schemas
 in Preview spec

Add ai_chatbot_availability, ai_copilot_availability, and
ai_sales_agent_availability to article_content and article_list_item
schemas in the Preview OpenAPI spec (descriptions/0/).

- article_content: fields propagate to translated_content per-locale objects
- article_list_item: fields appear at top-level article responses
- Updated inline response examples for 5 article endpoints

Source: intercom/intercom#508483
---
 descriptions/0/api.intercom.io.yaml | 42 +++++++++++++++++++++++++++++
 1 file changed, 42 insertions(+)

diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index 4daf336..2fbcd46 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -1249,6 +1249,9 @@ paths:
                       created_at: 1734537283
                       updated_at: 1734537283
                       url: http://help-center.test/myapp-64/en/articles/39-this-is-the-article-title
+                      ai_chatbot_availability: true
+                      ai_copilot_availability: true
+                      ai_sales_agent_availability: true
               schema:
                 "$ref": "#/components/schemas/article_list"
         '401':
@@ -1311,6 +1314,9 @@ paths:
                     created_at: 1734537288
                     updated_at: 1734537288
                     url: http://help-center.test/myapp-68/en/articles/42-thanks-for-everything
+                    ai_chatbot_availability: true
+                    ai_copilot_availability: true
+                    ai_sales_agent_availability: true
               schema:
                 "$ref": "#/components/schemas/article"
         '400':
@@ -1426,6 +1432,9 @@ paths:
                     created_at: 1734537292
                     updated_at: 1734537292
                     url: http://help-center.test/myapp-74/en/articles/45-this-is-the-article-title
+                    ai_chatbot_availability: true
+                    ai_copilot_availability: true
+                    ai_sales_agent_availability: true
               schema:
                 "$ref": "#/components/schemas/article"
         '404':
@@ -1510,6 +1519,9 @@ paths:
                     created_at: 1734537297
                     updated_at: 1734537298
                     url: http://help-center.test/myapp-80/en/articles/48-christmas-is-here
+                    ai_chatbot_availability: true
+                    ai_copilot_availability: true
+                    ai_sales_agent_availability: true
               schema:
                 "$ref": "#/components/schemas/article"
         '404':
@@ -1687,6 +1699,9 @@ paths:
                         created_at: 1734537306
                         updated_at: 1734537306
                         url:
+                        ai_chatbot_availability: true
+                        ai_copilot_availability: true
+                        ai_sales_agent_availability: true
                       highlights: []
                     pages:
                       type: pages
@@ -19386,6 +19401,18 @@ components:
           example:
           - 1
           - 2
+        ai_chatbot_availability:
+          type: boolean
+          description: Whether the article is available for AI Chatbot.
+          example: true
+        ai_copilot_availability:
+          type: boolean
+          description: Whether the article is available for AI Copilot.
+          example: true
+        ai_sales_agent_availability:
+          type: boolean
+          description: Whether the article is available for AI Sales Agent.
+          example: true
     internal_article_list:
       title: Internal Articles
       type: object
@@ -19597,6 +19624,21 @@ 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 article is available for AI Chatbot. For multilingual
+            articles, this will be the value of the default language's content.
+          example: true
+        ai_copilot_availability:
+          type: boolean
+          description: Whether the article is available for AI Copilot. For multilingual
+            articles, this will be the value of the default language's content.
+          example: true
+        ai_sales_agent_availability:
+          type: boolean
+          description: Whether the article is available for AI Sales Agent. For multilingual
+            articles, this will be the value of the default language's content.
+          example: true
     internal_article_list_item:
       title: Internal Articles
       type: object