Quickstart — your first answer

You need a bot (create one in the dashboard) and an API key.

1. Find your bot's id

2. Open a conversation

One conversation per end-user chat; reuse its id for follow-ups.

3. Ask a question

The response includes the assistantmessage, the sources it used, tokens spent and your new balance.

Guided playground

Log in, paste your key, pick a bot and run both steps — plus the no-key website track:

In your language

const conv = await (await fetch(${API}/chat/conversation/, { method: "POST", headers, body: JSON.stringify({ knowledgebase: 123, title: "Customer chat" }), })).json();

const reply = await (await fetch(${API}/chat/conversation/${conv.id}/send/, { method: "POST", headers, body: JSON.stringify({ content: "Hello!", apikey: process.env.BOTAPIKEY }), })).json(); console.log(reply.assistantmessage.content);

conv = requests.post(f"{API}/chat/conversation/", headers=H, json={"knowledgebase": 123, "title": "Customer chat"}).json() reply = requests.post(f"{API}/chat/conversation/{conv['id']}/send/", headers=H, json={"content": "Hello!", "apikey": H["X-API-Key"]}).json() print(reply["assistantmessage"]["content"])