From f316e463b127a5109eb2a35710aa847096d40ab1 Mon Sep 17 00:00:00 2001
From: Salman Shah <salman.shah@intercom.io>
Date: Mon, 16 Mar 2026 13:16:29 +0000
Subject: [PATCH] Document GET /fin_voice/conversation/{conversation_id} -
 missing endpoint

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
---
 descriptions/0/api.intercom.io.yaml    | 38 ++++++++++++++++++++++++++
 descriptions/2.15/api.intercom.io.yaml | 38 ++++++++++++++++++++++++++
 2 files changed, 76 insertions(+)

diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index 854f7c7..8944b2d 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -16439,6 +16439,44 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/error"
+  "/fin_voice/conversation/{conversation_id}":
+    get:
+      summary: Collect Fin Voice calls by conversation ID
+      description: |
+        Retrieve information about Fin Voice calls associated with a conversation.
+
+        Returns all matched calls for the given conversation ID. A conversation may have multiple associated calls.
+      operationId: collectFinVoiceCallsByConversationId
+      tags:
+        - Calls
+      parameters:
+        - name: conversation_id
+          in: path
+          required: true
+          description: The Intercom conversation identifier
+          schema:
+            type: string
+      responses:
+        '200':
+          description: successful
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/ai_call_response"
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        default:
+          description: Unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
 components:
   schemas:
     datetime:
diff --git a/descriptions/2.15/api.intercom.io.yaml b/descriptions/2.15/api.intercom.io.yaml
index af9b149..1342e26 100644
--- a/descriptions/2.15/api.intercom.io.yaml
+++ b/descriptions/2.15/api.intercom.io.yaml
@@ -14585,6 +14585,44 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/error"
+  "/fin_voice/conversation/{conversation_id}":
+    get:
+      summary: Collect Fin Voice calls by conversation ID
+      description: |
+        Retrieve information about Fin Voice calls associated with a conversation.
+
+        Returns all matched calls for the given conversation ID. A conversation may have multiple associated calls.
+      operationId: collectFinVoiceCallsByConversationId
+      tags:
+        - Calls
+      parameters:
+        - name: conversation_id
+          in: path
+          required: true
+          description: The Intercom conversation identifier
+          schema:
+            type: string
+      responses:
+        '200':
+          description: successful
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: "#/components/schemas/ai_call_response"
+        '401':
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
+        default:
+          description: Unexpected error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/error"
   "/export/workflows/{id}":
     get:
       summary: Export a workflow