> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usefini.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> List conversations, fetch a conversation, send message events, approve events, evaluate rules, and delete conversations through Fini's public API.

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.

<Info>
  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.
</Info>

## Reference pages

<CardGroup cols={2}>
  <Card title="List conversations" icon="list" href="/en/api-reference/list-conversations">
    `GET /v2/hc-interactions/public` - export conversations with filters and cursor pagination.
  </Card>

  <Card title="Get conversation" icon="eye" href="/en/api-reference/get-conversation">
    `GET /v2/hc-interactions/{id}/public` - fetch one conversation by ID.
  </Card>

  <Card title="Generate answer" icon="paper-plane" href="/en/api-reference/generate-answer">
    `POST /v2/hc-interactions/events/public` - add a message event and generate the next Fini response.
  </Card>

  <Card title="Approve event" icon="thumbs-up" href="/en/api-reference/approve-conversation-event">
    `POST /v2/hc-interactions/{id}/approve/public` - set or clear an event approval value.
  </Card>

  <Card title="Evaluate conversation rule" icon="diagram-project" href="/en/api-reference/evaluate-conversation-rule">
    `POST /v2/hc-interactions/{id}/evaluate-rule/{ruleId}/public` - run one rule against an existing conversation.
  </Card>

  <Card title="Delete conversation" icon="trash" href="/en/api-reference/delete-conversation">
    `DELETE /v2/hc-interactions/{id}/public` - delete one conversation.
  </Card>

  <Card title="Bulk delete conversations" icon="trash" href="/en/api-reference/bulk-delete-conversations">
    `DELETE /v2/hc-interactions/public` - delete up to 50 conversations by ID.
  </Card>
</CardGroup>

## Endpoint map

| Method   | Path                                                   | Scope   | Purpose                                                  |
| -------- | ------------------------------------------------------ | ------- | -------------------------------------------------------- |
| `GET`    | `/v2/hc-interactions/public`                           | `read`  | Export conversations with filters and cursor pagination. |
| `GET`    | `/v2/hc-interactions/:id/public`                       | `read`  | Fetch one conversation by ID.                            |
| `POST`   | `/v2/hc-interactions/events/public`                    | `write` | Add a message event and generate the next Fini response. |
| `POST`   | `/v2/hc-interactions/:id/approve/public`               | `write` | Set or clear an event approval value.                    |
| `POST`   | `/v2/hc-interactions/:id/evaluate-rule/:ruleId/public` | `write` | Evaluate one rule against an existing conversation.      |
| `DELETE` | `/v2/hc-interactions/:id/public`                       | `write` | Delete one conversation.                                 |
| `DELETE` | `/v2/hc-interactions/public`                           | `write` | Delete up to 50 conversations.                           |