Send a message into the ODIN room of a session
POST/api/projects/:projectId/sessions/:sessionId/room-messages
Push a custom message to the players of a live session. The transcription bot sends it into the ODIN room as a Cortex Room Protocol frame (bytes 0x43 0x58 "CX", a version byte, then JSON { type, id, seq, data }); clients receive it through MessageReceived from the bot peer. Pass targetExternalUserIds to reach only some players. Limits: 8 KB per encoded frame, 20 messages per second per room. Requires a bot in the room (an active session). Delivery is best effort in real time — for state a client must not miss, keep an authoritative copy it can fetch after a reconnect.
Request
Responses
- 202
- 400
- 403
- 404
- 409
- 413
- 429
Handed to the bot of the session
Invalid type or payload (e.g. a reserved cortex. type)
The credential lacks the rooms.push scope or access to this project
Session not found in this project
The session is not active, or no bot is connected to its room
The encoded frame exceeds 8 KB
The room exceeded 20 messages per second; see Retry-After