The Xentree conversation APIs power AI chat, note-taking, search, and learning-session tracking.Core capabilities#
create and list conversations
search across indexed data
manage per-conversation learning sessions
Authentication and scopes#
Conversations endpoints support both:Authorization: Bearer ...
Recommended API key scopes:conversations:read for list/search/read endpoints
conversations:write for create/update/delete endpoints
Main endpoints#
AI response generation#
Use this endpoint to send a user message and receive an AI-generated response.provider: model or routing mode such as auto
conversation_history: optional prior turns
user_language: optional response language hint
Providers#
Returns the currently available model/provider options.Conversations#
POST /api/core/conversations
GET /api/core/conversations
DELETE /api/core/conversations/{conversation_id}
Conversation messages#
GET /api/core/conversations/{conversation_id}/messages
Search#
Search maintenance (admin)#
GET /api/core/search/status
POST /api/core/search/reindex
Learning sessions (per conversation)#
POST /api/core/conversations/{conversation_id}/session/start
POST /api/core/conversations/{conversation_id}/session/activity
POST /api/core/conversations/{conversation_id}/session/end
GET /api/core/conversations/{conversation_id}/session/status
Notes#
PUT /api/core/notes/{note_id}
DELETE /api/core/notes/{note_id}
Notes on write operations#
Write endpoints such as create conversation, delete conversation, and session mutation operations require conversations:write when using API key auth.Example chat request#
{
"message": "Create a learning plan for my team.",
"provider": "auto",
"conversation_history": [],
"user_language": "en"
}
Example chat response#
{
"content": "Here is a structured learning plan for your team...",
"provider": "auto",
"model": "gpt-5-mini",
"usage": null
}
Modified at 2026-04-29 23:52:44