Skip to main content
POST
Chat with a chatbot
Looking for API v2? The new Chatbase API v2 features structured error codes, cursor-based pagination, and SSE streaming. Note that API v2 is available starting from the Standard Plan. Check out the API v2 Reference →

Authorizations

Authorization
string
header
required

API key in Bearer token format

Body

application/json
chatbotId
string
required

ID of the chatbot to chat with

Example:

"ckl123abc456"

messages
object[]
required

Array of messages in the conversation

conversationId
string

ID of existing conversation to continue, if not provided, the conversation will not be saved

Example:

"conv_abc123"

contactId
string

External ID of the contact/user

Example:

"user_123"

model
enum<string>

AI model to use for the response

Available options:
gpt-4o-mini,
gpt-oss-120b,
gpt-oss-20b,
gpt-5.2,
gpt-5.5,
gpt-5.6-terra,
gpt-6-luna,
gpt-6.1-sol,
claude-opus-5-5,
claude-sonnet-5-5,
claude-haiku-5-5,
gemini-2.5-pro,
gemini-3-flash,
gemini-3.1-flash-lite,
gemini-3.1-pro,
gemini-3.5-flash-lite,
gemini-3.6-flash,
gemini-3.8-flash,
grok-4.7,
DeepSeek-V3.1,
DeepSeek-R1,
DeepSeek-V4-Flash,
DeepSeek-V4.1-Flash,
kimi-k2.6,
mistral-medium-3.5,
mistral-small-2603,
glm-5.2,
glm-5.3-flash,
auto
Example:

"gpt-4o-mini"

temperature
number

Temperature setting for AI response creativity

Required range: 0 <= x <= 1
Example:

0.7

stream
boolean
default:false

Whether to stream the response

Response

Chat response

text
string

The chatbot's response text

Example:

"Hello! How can I help you today?"