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

# API Reference

> Complete API reference for the Clever AI Conversation Agent

The Clever AI API provides endpoints for managing conversations with the AI agent and handling customer service tickets. The API is organized around REST principles and returns JSON responses.

## Base URL

```bash theme={null}
https://clever.nivara.io/en
```

## Authentication

<Note>
  Authentication details will be provided separately. Contact Nivara supoort team for API credentials.
</Note>

## Response Format

All responses are returned in JSON format and include:

* Standard HTTP status codes
* Consistent error message format
* Detailed validation errors when applicable

### Error Responses

When an error occurs, you'll receive:

```json theme={null}
{
  "detail": [
    {
      "loc": ["field_name"],
      "msg": "Error message",
      "type": "error_type"
    }
  ]
}
```

## Available Endpoints

### Conversation Management

* [Start Conversation](/projects/clever-ai/api-reference/endpoint/start_conversation) - Start a new conversation
* [Send Message](/projects/clever-ai/api-reference/endpoint/send_message) - Send a message in a conversation
* [Get Conversation](/projects/clever-ai/api-reference/endpoint/get_conversation) - Get conversation details
* [List Conversations](/projects/clever-ai/api-reference/endpoint/list_conversations) - List all conversations
* [Reinit Conversation](/projects/clever-ai/api-reference/endpoint/reinit_conversation) - Reset a conversation

### Ticket Management

* [Get All Tickets](/projects/clever-ai/api-reference/endpoint/get_all_tickets) - List all tickets
* [Get Ticket](/projects/clever-ai/api-reference/endpoint/get_ticket) - Get specific ticket details
* [Get Tickets Summary](/projects/clever-ai/api-reference/endpoint/get_tickets_summary) - Get analytics and insights

## Language Support

The API supports two languages:

* English (`en`)
* Italian (`it`)

Language can be specified when starting a conversation or sending messages.