Tips for Traversing the AcxAPI

Working with Conversation IDs

Every conversation in the platform is assigned a unique identifier when it is processed. This identifier is the common thread across most endpoints in this documentation; you will encounter it under different field names depending on which endpoint you are calling, but it always refers to the same conversation.

SectionField Name
MetadataId
EvaluationsMetadata.Id (nested inside the Metadata object on each evaluation)
PV Data ReconciliationConversationId
InsightsConversationId
TranscriptionsConversationId (response) / conversationId (request)

A typical integration will retrieve conversation IDs from one section and pass them into another. For example, you might retrieve a list of conversations from Metadata, then use those IDs to fetch transcripts from Transcriptions, or pull classifier results from Insights.