From b4e605ac22d56d19f8449849c4b0a8974dccff44 Mon Sep 17 00:00:00 2001 From: Rahul D'Souza Date: Mon, 20 Apr 2026 17:25:01 +0100 Subject: [PATCH] Add intercom_conversation_id to Fin Agent API response schemas The intercom_conversation_id field has been globally enabled in the Fin Agent API but was missing from the OpenAPI specs. This adds it to the /fin/start and /fin/reply response schemas (both examples and properties) in versions 2.14, 2.15, and 0 (unstable). Co-Authored-By: Claude Opus 4.6 (1M context) --- descriptions/0/api.intercom.io.yaml | 12 ++++++++++++ descriptions/2.14/api.intercom.io.yaml | 12 ++++++++++++ descriptions/2.15/api.intercom.io.yaml | 12 ++++++++++++ 3 files changed, 36 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index 881cdb1..05adb88 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -2054,6 +2054,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '5678' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -2061,6 +2062,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '5678' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -2079,6 +2081,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The Intercom conversation ID associated with this Fin conversation. + example: '5678' user_id: type: string description: The ID of the user. @@ -2245,6 +2251,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '5678' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -2252,6 +2259,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '5678' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -2267,6 +2275,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The Intercom conversation ID associated with this Fin conversation. + example: '5678' user_id: type: string description: The ID of the user. diff --git a/descriptions/2.14/api.intercom.io.yaml b/descriptions/2.14/api.intercom.io.yaml index 1971528..1df6251 100644 --- a/descriptions/2.14/api.intercom.io.yaml +++ b/descriptions/2.14/api.intercom.io.yaml @@ -1835,6 +1835,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '5678' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -1842,6 +1843,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '5678' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -1860,6 +1862,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The Intercom conversation ID associated with this Fin conversation. + example: '5678' user_id: type: string description: The ID of the user. @@ -2025,6 +2031,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '5678' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -2032,6 +2039,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '5678' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -2047,6 +2055,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The Intercom conversation ID associated with this Fin conversation. + example: '5678' user_id: type: string description: The ID of the user. diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml index fd8aabe..327af10 100644 --- a/descriptions/2.15/api.intercom.io.yaml +++ b/descriptions/2.15/api.intercom.io.yaml @@ -1835,6 +1835,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '5678' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -1842,6 +1843,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '5678' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -1860,6 +1862,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The Intercom conversation ID associated with this Fin conversation. + example: '5678' user_id: type: string description: The ID of the user. @@ -2025,6 +2031,7 @@ paths: Successful response: value: conversation_id: ext-123 + intercom_conversation_id: '5678' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -2032,6 +2039,7 @@ paths: Response with attribute errors: value: conversation_id: ext-123 + intercom_conversation_id: '5678' user_id: user-456 status: thinking created_at_ms: '2025-01-24T10:00:00.123Z' @@ -2047,6 +2055,10 @@ paths: type: string description: The ID of the conversation. example: ext-123 + intercom_conversation_id: + type: string + description: The Intercom conversation ID associated with this Fin conversation. + example: '5678' user_id: type: string description: The ID of the user.