From 5522eec0a775a1a59f16ba244e5b6e323ba9b680 Mon Sep 17 00:00:00 2001
From: anubhav-intercom <anubhav.bohidar@intercom.io>
Date: Thu, 27 Aug 2026 13:41:27 +0100
Subject: [PATCH] Document `event_details` on standalone platform handoff parts

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---
 descriptions/0/api.intercom.io.yaml | 47 ++++++++++++++++++++++++++++-
 1 file changed, 46 insertions(+), 1 deletion(-)

diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml
index de71fc0..681db9c 100644
--- a/descriptions/0/api.intercom.io.yaml
+++ b/descriptions/0/api.intercom.io.yaml
@@ -12447,7 +12447,31 @@ paths:
                         event_details:
                           call_id: '3822007689'
                         app_package_code: null
-                      total_count: 5
+                      - type: conversation_part
+                        id: 6
+                        part_type: standalone_platform_handoff
+                        body:
+                        created_at: 1740141910
+                        updated_at: 1740141910
+                        notified_at: 1740141910
+                        assigned_to:
+                        author:
+                          type: bot
+                          id: '278'
+                          name: Fin
+                          email: operator+abcd1234@intercom.io
+                        attachments: []
+                        external_id:
+                        redacted: false
+                        email_message_metadata: null
+                        state: closed
+                        tags: []
+                        event_details:
+                          handoff:
+                            type: zendesk_ticket
+                            success: true
+                        app_package_code: null
+                      total_count: 6
                 email conversation with history found:
                   value:
                     type: conversation
@@ -36662,6 +36686,26 @@ components:
           type: string
           description: The id of the call the summary describes
           example: "3822007689"
+    standalone_platform_handoff:
+      title: Part type - standalone_platform_handoff
+      type: object
+      description: Contains the escalation target Fin handed the conversation off to, for conversation part type <code>standalone_platform_handoff</code>.
+      properties:
+        handoff:
+          type: object
+          description: The escalation Fin attempted.
+          properties:
+            type:
+              type: string
+              description: Where Fin handed the conversation off to. <code>zendesk_ticket</code> means a Zendesk ticket was created, and <code>zendesk_agent</code> means the conversation was handed over to a Zendesk agent for live chat.
+              enum:
+              - zendesk_ticket
+              - zendesk_agent
+              example: zendesk_ticket
+            success:
+              type: boolean
+              description: Whether the handoff completed. A handoff that did not complete falls back to a live agent, which is reported in a separate successful part.
+              example: true
     event_details:
       title: Event details of Workflow & actions
       type: object
@@ -36682,6 +36726,7 @@ components:
         - "$ref": "#/components/schemas/conversation_sla_unpaused"
         - "$ref": "#/components/schemas/conversation_sla_removed"
         - "$ref": "#/components/schemas/call_summary"
+        - "$ref": "#/components/schemas/standalone_platform_handoff"
     email_setting:
       type: object
       title: Email Setting