Chat

Send a webchat message

post/api/v1/chat

Request body

usernamestring

Caller-declared WebChat sender/session owner. This value is used as the message sender identity and may participate in sender-ID-based command permission checks. Treat chat-scoped API keys as trusted backend credentials and map or validate usernames before accepting end-user input.

session_idstring
conversation_idstring

Deprecated alias for session_id.

config_idstring
config_namestring
selected_providerstring
selected_modelstring
enable_streamingboolean

Deprecated compatibility field. It is used only when flags.enable_streaming is absent; otherwise flags.enable_streaming takes priority.

_skip_user_historyboolean

Internal WebUI flag for edit/regenerate flows.

_llm_checkpoint_idstring

Internal WebUI checkpoint override.

_platform_history_idstring

Internal WebUI platform history override.

_thread_selected_textstring

Internal WebUI side-thread context.

Response

Standard AstrBot success response

status'ok' required
messagestring
{"stackTrail":"components:schemas:SuccessEnvelope:properties:data","oasType":"schema","type":"unknown"}

Changes