From d1c96811ada9bb69835e9ce85a1faf2cb5d1534f Mon Sep 17 00:00:00 2001 From: Ivan Branimir Skoric <58559012+ib-skoric@users.noreply.github.com> Date: Wed, 7 Oct 2026 09:27:44 +0100 Subject: [PATCH] Document audience_ids on AI External Pages in 2.16 Co-Authored-By: Claude Opus 5.5 (1M context) --- descriptions/2.16/api.intercom.io.yaml | 55 ++++++++++++++++++++++++++ 1 file changed, 55 insertions(+) diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index 28400b1a..c536fabc 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/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: "

Test

" 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: "

Test

" 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