Skip to main content
POST
https://api.getpoppy.ai
/
api
/
conversation
/
{conversationId}
{
  "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 lets you continue an ongoing conversation with your assistant, keeping the context from previous messages.

​
URL Parameters

​
conversationId
string
required
The unique ID of the conversation thread you want to continue

​
Query Parameters

​
api_key
string
Your API key for authentication
​
board_id
string
required
The ID of the knowledge board containing your chat assistant
​
chat_id
string
required
The ID of the chat assistant you’re continuing the conversation with

​
Request Body

​
prompt
string
required
Your next message in the conversation
​
model
string
default:"claude-sonnet-4-5"
The AI model to use for generating the response (each model has different capabilities and pricing)
​
save_history
boolean
Whether to save this message exchange in your conversation history
​
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 exchange (will not be stored in conversation history)
​
user
string
Optional identifier for tracking who is sending the message
​
source
string
Optional identifier for tracking where the message came from

​
Response

​
text
string
The assistant’s response to your message
​
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
}