Skip to main content
POST
Send a message to a chat

Authorizations

Authorization
string
header
required

Personal access token (izap_pat_…) sent as Authorization: Bearer ; dashboard session JWTs are also accepted.

Path Parameters

chat_id
string<uuid>
required

Body

application/json

Schema for creating a new message in a chat

content
string
required
Maximum string length: 4096
attachments
MessageAttachment · object[] | null
sender
string | null
sender_user_id
string<uuid> | null

Response

Successful Response

Response for POST /chats/{chat_id}/messages.

ai_messages/ai_response_pending are absent on the human-assistant path (no AI reply was generated) and present on the AI path — kept absent rather than null via response_model_exclude_unset on the route.

user_message
ChatMessageSummaryOut · object
required

A chat message as embedded in the send-message responses below.

ai_messages
ChatMessageSummaryOut · object[] | null
ai_response_pending
boolean | null