Conversations

List conversations

string

required

Bearer token.

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}

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

string

required

The session ID of the conversation to rename.

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}

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

​List conversations

​Get conversation

​Rename conversation

​Delete conversation

​SDK usage

List conversations

Get conversation

Rename conversation

Delete conversation

SDK usage