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

# Conversations

> List, retrieve, rename, and delete conversations

## List conversations

<ParamField header="Authorization" type="string" required>
  Bearer token.
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Maximum number of conversations to return.
</ParamField>

```
GET /conversations
```

<ResponseExample>
  ```json 200 theme={null}
  {
    "conversations": [
      {
        "session_id": "sess_abc123",
        "title": "Revenue Analysis",
        "created_at": "2025-12-15T10:30:00Z",
        "last_updated": "2025-12-15T10:45:00Z",
        "turn_count": 5,
        "preview": "What was ACME's Q4 revenue?"
      }
    ]
  }
  ```
</ResponseExample>

## Get conversation

Retrieve the full message history for a conversation.

```
GET /conversations/{conversation_id}
```

<ParamField path="conversation_id" type="string" required>
  The session ID of the conversation.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "session_id": "sess_abc123",
    "title": "Revenue Analysis",
    "messages": [
      {
        "role": "user",
        "content": "What was ACME's Q4 revenue?",
        "timestamp": "2025-12-15T10:30:00Z"
      },
      {
        "role": "assistant",
        "content": "ACME Corp reported $50M revenue in Q4 2025...",
        "timestamp": "2025-12-15T10:30:05Z"
      }
    ]
  }
  ```
</ResponseExample>

## Rename conversation

```
PUT /conversations/{conversation_id}/title
```

<ParamField path="conversation_id" type="string" required>
  The session ID of the conversation to rename.
</ParamField>

<ParamField body="title" type="string" required>
  The new title for the conversation.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "message": "Conversation renamed"
  }
  ```
</ResponseExample>

## Delete conversation

Soft-deletes a conversation. The data is retained but no longer appears in listings.

```
DELETE /conversations/{conversation_id}
```

<ParamField path="conversation_id" type="string" required>
  The session ID of the conversation to delete.
</ParamField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "message": "Conversation deleted"
  }
  ```
</ResponseExample>

### SDK usage

```python theme={null}
# List conversations
conversations = client.list_conversations(limit=20)

# Get full history
history = client.get_conversation("sess_abc123")

# Rename
client.rename_conversation("sess_abc123", "Revenue Analysis")

# Delete
client.delete_conversation("sess_abc123")
```