Skip to content

Send message

POST
/workspaces/{workspace_id}/chat

Send a message to the AI assistant and receive a response. Supports streaming via Server-Sent Events.

workspace_id
required
string format: uuid

Workspace ID

object
message
required

User message

string
stream

Enable streaming response

boolean
default: true
include_history

Include conversation history

boolean
default: true
scenario_id

Active scenario for context

string format: uuid
stack_id

Active stack for context

string format: uuid
model

Override default model

string
temperature
number
<= 2

Chat response (streaming or complete)

object
message
object
id
string format: uuid
role
string
Allowed values: user assistant agent
content
string
agent_name
string
created_at
string format: date-time
citations
Array<object>
object
number
integer
source_id
string
chunk_text
string
usage
object
input_tokens
integer
output_tokens
integer