Maintain and manage conversations

Continue a conversation

Include the first response's conversation_id in later calls. Never reuse it between users or sessions that must not share context.

{"message":"Can you expand on the second point?","conversation_id":"conversation-uuid","metadata":{}}

Retrieve messages

GET /v1/agents/{AGENT_ID}/conversations/{CONVERSATION_ID}/messages?page=1&page_size=50

The result includes messages, total, and has_more for pagination.

Delete the conversation

DELETE /v1/agents/{AGENT_ID}/conversations/{CONVERSATION_ID}

A successful deletion returns 204. Use it for user deletion requests or retention policy.