Add message to conversation | The most advanced AI retrieval system. Agentic Retrieval-Augmented Generation (RAG) with a RESTful API.

1 from r2r import R2RClient 2 3 client = R2RClient() 4 # when using auth, do client.login(...) 5 6 result = client.conversations.add_message( 7 "123e4567-e89b-12d3-a456-426614174000", 8 content="Hello, world!", 9 role="user", 10 parent_id="parent_message_id", 11 metadata={"key": "value"} 12 )

1 { 2 "results": { 3 "id": "id", 4 "message": { 5 "role": "user", 6 "content": "This is a test message.", 7 "name": "name", 8 "function_call": { 9 "key": "value" 10 }, 11 "tool_calls": [ 12 { 13 "key": "value" 14 } 15 ], 16 "tool_call_id": "tool_call_id", 17 "metadata": { 18 "key": "value" 19 }, 20 "structured_content": [ 21 { 22 "key": "value" 23 } 24 ], 25 "image_url": "image_url" 26 }, 27 "metadata": { 28 "key": "value" 29 } 30 } 31 }

Add a new message to a conversation.

This endpoint adds a new message to an existing conversation.

Path parameters

idstringRequired

The unique identifier of the conversation

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

X-API-KeystringRequired

Request

This endpoint expects an object.

contentstringRequired

The content of the message to add

rolestringRequired

The role of the message to add

parent_idstringOptionalformat: "uuid"

The ID of the parent message, if any

metadatamap from strings to optional stringsOptional

Additional metadata for the message

Response

Successful Response

resultsobject

Path parameters

Headers

Request

Response

Errors