List Conversations

Retrieves all conversations for the authenticated user.

Endpoint

GET /v1/conversations

Authentication

Requires a valid API key or user authentication token.

Response

Returns an array of conversation objects.

Response Format

[
  {
    "id": "string",
    "agent_id": "string",
    "title": "string",
    "created_at": "datetime",
    "updated_at": "datetime",
    "created_by": "string",
    "status": "string",
    "room_name": "string",
    "room_url": "string",
    "token": "string"
  }
]

Response Fields

Field	Type	Description
id	string	Unique identifier for the conversation
agent_id	string	ID of the agent participating in the conversation
title	string	Title of the conversation
created_at	datetime	When the conversation was created
updated_at	datetime	When the conversation was last updated
created_by	string	ID of the user who created the conversation
status	string	Current status ("active", "completed")
room_name	string	LiveKit room identifier
room_url	string	WebSocket URL for LiveKit connection
token	string	Authentication token for the room

Example Request

curl -X GET "https://api.krosai.com/v1/conversations" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

[
  {
    "id": "conv-b2c3d4e5-f6g7-8901-bcde-fg2345678901",
    "agent_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": "Product Support Session",
    "created_at": "2023-07-10T15:30:00Z",
    "updated_at": "2023-07-10T15:30:00Z",
    "created_by": "user-12345",
    "status": "active",
    "room_name": "conv-b2c3d4e5-f6g7-8901-bcde-fg2345678901",
    "room_url": "wss://livekit.krosai.com/room/conv-b2c3d4e5-f6g7-8901-bcde-fg2345678901",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  },
  {
    "id": "conv-c3d4e5f6-g7h8-9012-cdef-gh3456789012",
    "agent_id": "b2c3d4e5-f6g7-8901-bcde-fg2345678901",
    "title": "Technical Discussion",
    "created_at": "2023-07-09T10:15:00Z",
    "updated_at": "2023-07-09T11:30:00Z",
    "created_by": "user-12345",
    "status": "completed",
    "room_name": "conv-c3d4e5f6-g7h8-9012-cdef-gh3456789012",
    "room_url": "wss://livekit.krosai.com/room/conv-c3d4e5f6-g7h8-9012-cdef-gh3456789012",
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
]

Error Responses