Send a message in a chat

post

https://backend.psyco.ai/enterprise/staging/chats/{chatId}/messages

Sends a message in a chat. Supports three response modes controlled by request headers:

Mode	Header	Response
Synchronous (default)	(none)	`200` with the full AI response
Streaming	`Accept: text/event-stream`	`200` as Server-Sent Events (SSE)
Async	`Prefer: respond-async`	`202` with the generated `messageId`; processing continues in background

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

chatId

string

required

Body Params

onlyAppend

boolean

Optional. If true, the message will be appended to the existing chat history. This do not generate a response.

isHideMessage

boolean

Optional. If true, the message will not be displayed in the chat message list.

from

string

enum

Optional. The origin of the message. Required if onlyAppend is true.

Allowed:

content

object

required

Headers

Prefer

string

enum

Use respond-async to process the message asynchronously. The server returns 202 Accepted
immediately with the generated message id. Processing continues in the background.

Allowed:

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

400

Bad Request

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/event-stream

200Message sent and AI response received (synchronous mode). When Accept: text/event-stream is sent, the response is a Server-Sent Events stream.

202Accepted — async mode only (Prefer: respond-async). The message was accepted for processing. The AI response will be delivered asynchronously.

401Unauthorized