Skip to main content
Conversations are the customer interaction records behind Inbox, testing, approval, and answer-generation workflows. Use these routes to export conversation data, send a new message event, approve or reject an event, evaluate a rule against an existing conversation, or delete conversations.
The wire-format paths use /hc-interactions because that is the current backend contract. In this reference, we call them conversations to match the product surface.

Reference pages

List conversations

GET /v2/hc-interactions/public - export conversations with filters and cursor pagination.

Get conversation

GET /v2/hc-interactions/{id}/public - fetch one conversation by ID.

Generate answer

POST /v2/hc-interactions/events/public - add a message event and generate the next Fini response.

Approve event

POST /v2/hc-interactions/{id}/approve/public - set or clear an event approval value.

Evaluate conversation rule

POST /v2/hc-interactions/{id}/evaluate-rule/{ruleId}/public - run one rule against an existing conversation.

Delete conversation

DELETE /v2/hc-interactions/{id}/public - delete one conversation.

Bulk delete conversations

DELETE /v2/hc-interactions/public - delete up to 50 conversations by ID.

Endpoint map