From 8a6ff7196f2f8885fcde0677da5ce97f7a5eb205 Mon Sep 17 00:00:00 2001 From: Rahul D'Souza Date: Fri, 2 Oct 2026 11:10:24 +0100 Subject: [PATCH] Document content sources on Fin Agent API replied events Adds the optional `message.sources` array to the fin_replied event schema in 2.14, 2.15, 2.16 and Preview. Each source carries a title, a type (article or external) and a url. Co-Authored-By: Claude Opus 5 --- descriptions/0/api.intercom.io.yaml | 31 ++++++++++++++++++++++++++ descriptions/2.14/api.intercom.io.yaml | 31 ++++++++++++++++++++++++++ descriptions/2.15/api.intercom.io.yaml | 31 ++++++++++++++++++++++++++ descriptions/2.16/api.intercom.io.yaml | 31 ++++++++++++++++++++++++++ 4 files changed, 124 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index ad7889c9..a01b9e9d 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -39109,6 +39109,37 @@ components: format: date-time description: The timestamp the message was created at, with millisecond precision. example: '2025-01-24T09:01:00.456Z' + sources: + type: array + description: | + The content sources Fin used to generate this reply, in the same order as the + [n] citation markers in the body. Present only when Fin cited content. + items: + type: object + properties: + title: + type: string + description: The title of the source. + example: Managing your account + type: + type: string + enum: + - article + - external + description: Whether the source is an Intercom article or external content. + example: article + url: + type: string + description: The URL of the source. + example: https://www.example.com/help/en/articles/1-managing-your-account + required: + - title + - type + - url + example: + - title: Managing your account + type: article + url: https://www.example.com/help/en/articles/1-managing-your-account required: - author - body diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 9a1bcb0e..11f1c6c6 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -21010,6 +21010,37 @@ components: format: date-time description: The timestamp the message was created at, with millisecond precision. example: '2025-01-24T09:01:00.456Z' + sources: + type: array + description: | + The content sources Fin used to generate this reply, in the same order as the + [n] citation markers in the body. Present only when Fin cited content. + items: + type: object + properties: + title: + type: string + description: The title of the source. + example: Managing your account + type: + type: string + enum: + - article + - external + description: Whether the source is an Intercom article or external content. + example: article + url: + type: string + description: The URL of the source. + example: https://www.example.com/help/en/articles/1-managing-your-account + required: + - title + - type + - url + example: + - title: Managing your account + type: article + url: https://www.example.com/help/en/articles/1-managing-your-account required: - author - body diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index e89ebc81..e46943d9 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -21923,6 +21923,37 @@ components: format: date-time description: The timestamp the message was created at, with millisecond precision. example: '2025-01-24T09:01:00.456Z' + sources: + type: array + description: | + The content sources Fin used to generate this reply, in the same order as the + [n] citation markers in the body. Present only when Fin cited content. + items: + type: object + properties: + title: + type: string + description: The title of the source. + example: Managing your account + type: + type: string + enum: + - article + - external + description: Whether the source is an Intercom article or external content. + example: article + url: + type: string + description: The URL of the source. + example: https://www.example.com/help/en/articles/1-managing-your-account + required: + - title + - type + - url + example: + - title: Managing your account + type: article + url: https://www.example.com/help/en/articles/1-managing-your-account required: - author - body diff --git a/descriptions/2.16/api.intercom.io.yaml b/descriptions/2.16/api.intercom.io.yaml index 62c5c8bc..e6ac01cb 100644 --- a/descriptions/2.16/api.intercom.io.yaml +++ b/descriptions/2.16/api.intercom.io.yaml @@ -32427,6 +32427,37 @@ components: format: date-time description: The timestamp the message was created at, with millisecond precision. example: '2025-01-24T09:01:00.456Z' + sources: + type: array + description: | + The content sources Fin used to generate this reply, in the same order as the + [n] citation markers in the body. Present only when Fin cited content. + items: + type: object + properties: + title: + type: string + description: The title of the source. + example: Managing your account + type: + type: string + enum: + - article + - external + description: Whether the source is an Intercom article or external content. + example: article + url: + type: string + description: The URL of the source. + example: https://www.example.com/help/en/articles/1-managing-your-account + required: + - title + - type + - url + example: + - title: Managing your account + type: article + url: https://www.example.com/help/en/articles/1-managing-your-account required: - author - body