API v1
API v1 Reference
The stable Chatmount Chat API. One endpoint — POST /v1/chat — with API-key authentication scoped per chatbot. Use this for production traffic; v2 is in beta.
Introduction
Integrate your Chatmount chatbot into any application. Send messages, receive AI-powered responses with source citations, and build custom chat experiences — all through a single REST endpoint.
The API uses the same RAG pipeline as the embedded widget — your chatbot’s training data, system prompt, and behavior are identical across every channel.
Base URL
POST https://services.chatmount.co/v1/chatAll v1 endpoints are scoped to a single chatbot. The chatbot id is determined by the API key you send — there is no path parameter for it. To talk to a different chatbot, generate a new key for that chatbot.
What you can do
- Send a single-turn message and receive a complete reply (default).
- Stream the reply token-by-token over Server-Sent Events (
stream: true). - Maintain multi-turn context across requests with the
session_idfield. - Receive source citations alongside the answer so you can show the user where the information came from.
Next steps
New here? Generate a key from the dashboard, then make your first request — the rest of the reference walks through every field, header, and error case.
Related
Authentication
How API keys work, what they look like, and which plans include API access.
Quick start
Send your first message in under a minute — copy-paste request and response.
Chat with a chatbot
Full POST /v1/chat reference — every request field, every response field.
Code examples
End-to-end Python, Node.js, and cURL examples with error handling and streaming.