Document audience_ids on AI External Pages in 2.16

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

Author: ib-skoric

descriptions/2.16/api.intercom.io.yaml

@@ -1807,6 +1807,7 @@ paths:
                       locale: en
                       source_id: 42
                       external_id: '3'
+                      audience_ids: []
                       created_at: 1734537269
                       updated_at: 1734537269
                       last_ingested_at: 1734537269
@@ -1822,6 +1823,7 @@ paths:
                       locale: en
                       source_id: 41
                       external_id: '2'
+                      audience_ids: []
                       created_at: 1734537269
                       updated_at: 1734537269
                       last_ingested_at: 1734537269
@@ -1837,6 +1839,7 @@ paths:
                       locale: en
                       source_id: 40
                       external_id: '1'
+                      audience_ids: []
                       created_at: 1734537269
                       updated_at: 1734537269
                       last_ingested_at: 1734537269
@@ -1896,6 +1899,9 @@ paths:
                     locale: en
                     source_id: 44
                     external_id: abc1234
+                    audience_ids:
+                    - 1
+                    - 2
                     created_at: 1734537273
                     updated_at: 1734537274
                     last_ingested_at: 1734537274
@@ -1924,6 +1930,9 @@ paths:
               successful:
                 summary: successful
                 value:
+                  audience_ids:
+                  - 1
+                  - 2
                   external_id: abc1234
                   html: "<html><body><h1>Test</h1></body></html>"
                   locale: en
@@ -1970,6 +1979,7 @@ paths:
                     locale: en
                     source_id: 45
                     external_id: '4'
+                    audience_ids: []
                     created_at: 1734537276
                     updated_at: 1734537276
                     last_ingested_at: 1734537276
@@ -2020,6 +2030,7 @@ paths:
                     locale: en
                     source_id: 46
                     external_id: '5'
+                    audience_ids: []
                     created_at: 1734537278
                     updated_at: 1734537278
                     last_ingested_at: 1734537278
@@ -2071,6 +2082,9 @@ paths:
                     locale: en
                     source_id: 47
                     external_id: '5678'
+                    audience_ids:
+                    - 1
+                    - 2
                     created_at: 1734537280
                     updated_at: 1734537281
                     last_ingested_at: 1734537281
@@ -2099,6 +2113,9 @@ paths:
               successful:
                 summary: successful
                 value:
+                  audience_ids:
+                  - 1
+                  - 2
                   external_id: '5678'
                   html: "<html><body><h1>Test</h1></body></html>"
                   locale: en
@@ -29227,6 +29244,21 @@ components:
           description: The identifier for the external page which was given by the
             source. Must be unique for the source.
           example: '5678'
+        audience_ids:
+          type: array
+          nullable: true
+          description: >-
+            The list of audience IDs to target this external page to for Fin AI Agent.
+            Omitting the field keeps the default audience inherited from the source.
+            Pass `[]` to clear all audience memberships, including the inherited ones.
+            If an external page already exists with the specified source_id and external_id,
+            omitting the field leaves its audience memberships unchanged.
+            Unknown audience IDs return a `404` error.
+          items:
+            type: integer
+          example:
+          - 1
+          - 2
       required:
       - title
       - html
@@ -32094,6 +32126,15 @@ components:
           description: The identifier for the external page which was given by the
             source. Must be unique for the source.
           example: '5678'
+        audience_ids:
+          type: array
+          description: The list of audience IDs that this external page is targeted
+            to for Fin AI Agent. Empty when the external page has no audience targeting.
+          items:
+            type: integer
+          example:
+          - 1
+          - 2
         created_at:
           type: integer
           format: date-time
@@ -35855,6 +35896,20 @@ components:
           description: The identifier for the external page which was given by the
             source. Must be unique for the source.
           example: '5678'
+        audience_ids:
+          type: array
+          nullable: true
+          description: >-
+            The list of audience IDs to target this external page to for Fin AI Agent.
+            Replaces all existing audience memberships.
+            Omitting the field leaves existing audience memberships unchanged.
+            Pass `[]` to clear all audience memberships.
+            Unknown audience IDs return a `404` error.
+          items:
+            type: integer
+          example:
+          - 1
+          - 2
       required:
       - title
       - html