Skip to main content
Conversations are the customer interaction records behind Inbox, testing, feedback, and answer-generation workflows. Use these routes to export conversation data, send a new message event, record thumbs-up or thumbs-down feedback on 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.

Get event metadata

GET /v2/hc-events/{id}/metadata - fetch the trace metadata for one Fini-authored event.

Generate answer

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

Send feedback

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

Mark feedback resolved

POST /v2/hc-interactions/{id}/feedback-resolved/public - mark a negatively rated event resolved or unresolved.

Add feedback note

POST /v2/hc-interactions/{id}/feedback-note/public - save a teammate feedback note on an event.

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