POST/rooms/:name/send-app-message
POST
/rooms/:name/send-app-message
Sends a message to participants within a room.
Messages are delivered to participants currently in the call. They are not stored. If a recipient is not in the call when the message is sent, the recipient will never receive the message.
In the case of an error, returns an HTTP error with information about the error in the response body.
You can listen for these messages by installing a handler for the app-message
event.
Path params
string
The name of the room.
Body params
object
A javascript object that can be serialized into JSON. Data sent must be within the 4kb size limit.
string
Determines who will recieve the message. It can be either a participant session_id, or *
. The *
value is the default, and means that the message is a "broadcast" message intended for all participants.
Default: *