Conversation Management

Get Messages By User `GET` /v1/api/conversation

Resource URL	/v1/api/conversation/
Response Format	JSON
Requires Authentication	Yes
Rate Limited	Yes
HTTPS	Yes

Description

Retrieve messages associated with a specific user, with optional pagination and filtering by document or collection.

Parameters

Parameter	Description	Required	Type	Default Value
user	Identifier of the user	Yes	String	N/A
page	Page number for pagination	No	Integer	1
page_size	Number of messages per page	No	Integer	10
document_id	Filter by document ID (optional)	No	String or Null	N/A
collection_id	Filter by collection ID (optional)	No	String or Null	N/A

Example Request

curl -X 'GET' \
'https://braegen.ai/v1/api/conversation/?user=jane.smith&page=1&page_size=5&document_id=doc_001' \
-H 'accept: application/json'

Example Request

{
    "is_error": false,
    "message": "Messages retrieved successfully",
    "results": {
        "user": "jane.smith",
        "messages": [
            {
                "id": "msg_001",
                "content": "Hello, how can I assist you?",
                "timestamp": "2025-04-07T10:00:00Z"
            },
            {
                "id": "msg_002",
                "content": "Please review document doc_001.",
                "timestamp": "2025-04-07T10:05:00Z"
            }
        ],
        "page": 1,
        "page_size": 5,
        "total": 2
    }
}

HTTP Response

HTTP Code	Message
200	Successful Response
422	Validation Error

Conversation Management

Get Messages By User GET /v1/api/conversation

Description

Parameters

Example Request

Example Request

HTTP Response

On this page

Get Messages By User `GET` /v1/api/conversation