Document content sources on Fin Agent API replied events

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

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

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

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