Add message to conversation

POST

Add a new message to a conversation.

This endpoint adds a new message to an existing conversation.

idstringRequired

The unique identifier of the conversation

AuthorizationstringRequired

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

X-API-KeystringRequired

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

Successful Response

resultsobject

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	},
21	"metadata": {
22	"key": "value"
23	}
24	}
25	}