Skip to main content

​
List conversations

​
Authorization
string
required
Bearer token.
​
limit
integer
default:"50"
Maximum number of conversations to return.
GET /conversations

{
  "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?"
    }
  ]
}

​
Get conversation

Retrieve the full message history for a conversation. 
GET /conversations/{conversation_id}
​
conversation_id
string
required
The session ID of the conversation.
{
  "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"
    }
  ]
}

​
Rename conversation

PUT /conversations/{conversation_id}/title
​
conversation_id
string
required
The session ID of the conversation to rename.
​
title
string
required
The new title for the conversation.
{
  "success": true,
  "message": "Conversation renamed"
}

​
Delete conversation

Soft-deletes a conversation. The data is retained but no longer appears in listings. 
DELETE /conversations/{conversation_id}
​
conversation_id
string
required
The session ID of the conversation to delete.
{
  "success": true,
  "message": "Conversation deleted"
}

​
SDK usage

# 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")