Intercom API (unofficial showcase)
GET/conversations/{id}/hitl_events

List conversation HITL events

Lists human-in-the-loop events from Fin consultations on a conversation, ordered from oldest to newest. Use the events to review consultation steps and their associated data; a consultation appears only after it has ended. Access requires the read_conversations OAuth scope and permission to access the conversation.

2 parameters
idstringrequired
The identifier of the conversation whose HITL events to list.
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

3 status codes
200Returns HITL event objects in chronological order, including each event's type, consultation identifier, timestamp, and event-specific data.
typestringoptional
The type of the object.
Allowed:list
dataarray<HITLEvent>optional
An array of HITL event objects.
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. The authenticated user must also be able to access that conversation.