Skip to main content
POST
/
conversations
/
{conversation_id}
/
messages
Add Message
curl --request POST \
  --url https://api.example.com/conversations/{conversation_id}/messages

​
Path Parameters

ParameterTypeDescription
conversation_idstringConversation ID

​
Request Body

{
  "role": "user",
  "content": "What were the top products?"
}
FieldTypeRequiredDescription
rolestringyesMust be user
contentstringyesMessage text
message_idstringnoStable caller-provided message id
metadataobjectnoOptional message metadata

​
Response

{
  "id": "msg_abc123",
  "conversation_id": "conv_abc123",
  "role": "user",
  "content": "What were the top products?",
  "timestamp": "2026-03-15T10:31:00Z"
}