Skip to main content
The chat API provides endpoints for single-turn completions, multi-turn conversations, tool-enabled chat, and agentic (autonomous) execution.

POST /api/chat/completions

Single-turn chat completion. Supports streaming.
Request body Response 200

POST /api/chat/quick

Simplified single-prompt endpoint.

POST /api/chat/smart

Context-aware chat that automatically injects task or ticket context.

Conversation Management

GET /api/chat/conversations

List conversations with optional filters.

POST /api/chat/conversations

Create a conversation.

GET /api/chat/conversations/:id

Get a conversation with its message history.

DELETE /api/chat/conversations/:id

Delete a conversation and all its messages.

POST /api/chat/conversations/:id/messages

Send a message in a conversation (full context + history).
Response includes userMessage, assistantMessage, usage, and optional compaction info.

POST /api/chat/conversations/:id/messages/with-tools

Send a message with native tool calling enabled (up to 5 tool roundtrips).
Security modes: deny | sandbox | allowlist | ask | full

POST /api/chat/conversations/:id/messages/agentic

Run agentic (autonomous) execution via SSE. See Chat Stream for the event format.

Models and Providers

Provider types

anthropic | openai | azure | google | ollama | openrouter | groq | xai | mistral | cohere | perplexity | deepseek | together | cerebras | fireworks

Tool Approval

Decisions: allow-once | allow-always | deny