From 1dee2df0fe4e9391727e881801ecd3af1c3033ee Mon Sep 17 00:00:00 2001 From: AAnkudovich Date: Thu, 7 May 2026 16:25:37 +0100 Subject: [PATCH] Add timing metrics to Calls API schema Add duration, talk_time, queue_time, and hold_time fields to the call schema and GET /calls/{id} example response, matching the public API changes shipped in intercom/intercom PR #506158. Co-Authored-By: Claude Opus 4.6 --- descriptions/0/api.intercom.io.yaml | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/descriptions/0/api.intercom.io.yaml b/descriptions/0/api.intercom.io.yaml index e6c5085..2bb8f13 100644 --- a/descriptions/0/api.intercom.io.yaml +++ b/descriptions/0/api.intercom.io.yaml @@ -14732,6 +14732,10 @@ paths: phone: "+15551234567" fin_recording_url: "https://api.intercom.io/calls/124/recording" fin_transcription_url: "https://api.intercom.io/calls/124/transcript" + duration: 90 + talk_time: 85 + queue_time: 3 + hold_time: null schema: "$ref": "#/components/schemas/call" '404': @@ -23528,6 +23532,26 @@ components: format: uri nullable: true description: API URL to the AI Agent (Fin) call transcript if available. + duration: + type: integer + nullable: true + description: Total call duration in seconds from the caller's perspective. For inbound calls, measured from initiated to ended. For outbound calls, measured from answered to ended. + example: 900 + talk_time: + type: integer + nullable: true + description: Total time in seconds the agent and customer were connected. + example: 300 + queue_time: + type: integer + nullable: true + description: Total time in seconds the caller waited in queue before connecting, when assigned to a team. + example: 45 + hold_time: + type: integer + nullable: true + description: Total time in seconds the caller was placed on hold during the call. + example: 60 call_list: title: Calls type: object