Skip to main content
POST
https://api.getpoppy.ai
/
api
/
conversation
{
  "board_id": "winter-frost-CJk4G",
  "chat_id": "chatNode-patient-star-4uIJt",
  "prompt": "What is my favourite number?",
  "model": "gpt-4o",
  "additional_context": "My favourite number is 444"
}

{
  "text": "Based on the information available, your favorite number is 444.",
  "credits_used": 0.04975,
  "credits_remaining": 1853.74585
}
This endpoint allows you to ask a question and get an answer that incorporates all your connected knowledge sources and documents.

​
Request Parameters

​
api_key
string
Your API key for authentication
​
board_id
string
required
The ID of the knowledge board you want to use
​
chat_id
string
required
The ID of the chat assistant you’re sending the question to

​
Request Body

​
prompt
string
required
Your question for the assistant
​
model
string
default:"claude-sonnet-4-5"
The AI model to use. Allowed values: claude-sonnet-4-5, o3-mini, gpt-4o, grok-2-1212, gpt-4o-mini
​
plaintext
string
default:false
Force the AI response to use plain text instead of markdown. Allowed values are “true” or “active”. Any other value will disable plaintext.
​
streaming
string
default:false
Return the answer as a stream instead of a JSON. Allowed values are “true” or “active”. Any other value will disable streaming.
​
additional_context
string
default:" "
Extra information you want to include for this specific question (will not be stored in your knowledge base)

​
Response

​
text
string
The assistant’s response to your question
​
credits_used
number
The number of credits consumed by this request
​
credits_remaining
number
Your account’s remaining credit balance for the current billing period
{
  "board_id": "winter-frost-CJk4G",
  "chat_id": "chatNode-patient-star-4uIJt",
  "prompt": "What is my favourite number?",
  "model": "gpt-4o",
  "additional_context": "My favourite number is 444"
}

{
  "text": "Based on the information available, your favorite number is 444.",
  "credits_used": 0.04975,
  "credits_remaining": 1853.74585
}