Append a message event

Operation boundary

Caller: Trusted backend only
Scope: visibility is stored as event metadata; current Product HTTP message synchronization does not use it as an access-control filter.

POST/message/event

Validates and applies one message-scoped event projection; non-null headers are unsupported.

Request Body

application/json

Event to project onto one message.

TypeScript Definitions

Use the request body type in TypeScript.

Message-event projection parameters.

channel_id*string

Target non-blank Channel ID; person and Agent Channels are normalized by the use case.

Match\S

Length1 <= length

channel_type*integer

Numeric Channel type; 1 is a person Channel, 2 is a group Channel, and other values are extension types.

Formatuint8

Range1 <= value <= 255

from_uid?string

Event actor UID; person or unencoded Agent Channel normalization may require it.

message_id?integer

Optional server message ID; positive values become uint64, while 0 or negative values are omitted from the event command.

Formatint64

client_msg_no*string

Non-blank client message number of the message receiving the event.

Match\S

Length1 <= length

event_id*string

Non-blank unique identifier of this event.

Match\S

Length1 <= length

event_type*string

Event type; surrounding whitespace is removed and the value is lowercased.

Match

^\s*[sS][tT][rR][eE][aA][mM]\.(?:[oO][pP][eE][nN]|[dD][eE][lL][tT][aA]|[cC][lL][oO][sS][eE]|[eE][rR][rR][oO][rR]|[cC][aA][nN][cC][eE][lL]|[sS][nN][aA][pP][sS][hH][oO][tT]|[fF][iI][nN][iI][sS][hH])\s*$

Length1 <= length

event_key?string

Event lane key; empty selects the default lane and stream.finish forces the finish lane.

visibility?string

Caller-supplied event metadata stored after trimming; current Product HTTP message synchronization does not use it as an access-control filter.

occurred_at?integer

Caller-supplied integer event time; the entry does not interpret its unit.

Formatint64

payload?unknown

Arbitrary JSON event payload passed to event storage as raw JSON bytes.

headers?null

Deprecated

Reserved field; it must be omitted or null, and every non-null JSON value is rejected.

[key: string]?any

Response Body

`application/json`

{  "status": 200,  "data": {    "client_msg_no": "string",    "event_key": "string",    "event_id": "string",    "msg_event_seq": 0,    "stream_status": "open",    "channel_id": "string",    "channel_type": 0,    "from_uid": "string"  }}

Append a message event

Request Body

Response Body

200application/json

400application/json

503application/json

`application/json`

`application/json`

`application/json`