Conversations

Create sessions, send messages, and manage chat conversations for your projects. Use these endpoints to programmatically interact with your chatbot — create conversations, send and receive messages, list sessions, and update session state.

All endpoints require project_uid to identify the project. The project must have an active chatbot configuration.

Create Session

Start a new chatbot conversation session.

Send Message

Send a message and get an AI response.

Get Sessions

List conversation sessions with filters.

Get Session Messages

Retrieve messages from a specific session.

Update Session

Update session state, mode, or segment.

Permissions

Endpoint	Required scope
Create Session	`conversations:write` (owner, editor, operator)
Send Message	`conversations:write` (owner, editor, operator)
Get Sessions	`conversations:read` (owner, editor, viewer, operator)
Get Session Messages	`conversations:read` (owner, editor, viewer, operator)
Update Session	`conversations:write` (owner, editor, operator)