GET
/conversations/{id}/handling_eventsList conversation handling events
Lists pause and resume handling events for a conversation, including the teammate and timestamp for each event. Use this operation when you need to review when teammates paused or resumed handling. Access requires the read_conversations OAuth scope.
idstringrequired
The identifier of the conversation whose handling events to list.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
200Returns the conversation's handling events, including the teammate, event type, timestamp, and optional reason.
handling_eventsarray<HandlingEvent>optional
Array of handling events
401Returned when the request is not authenticated or lacks the required OAuth scope.
typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
404Returned when the conversation cannot be found.
typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
Error handling
A 401 is returned when authentication is missing or the request lacks the read_conversations OAuth scope. A 404 is returned when the id path parameter does not identify a conversation.