Scheduled messages

Schedule a message to be delivered later. The composer stores content in D1 and the Room DO dispatches at send_at through the normal send path (same moderation, firmware, and fan-out rules as immediate sends).

In chat

1. Type your message in the composer.
2. Open + menu → Schedule send (ScheduleSend component).
3. Pick date/time and confirm.
4. View pending scheduled items in the panel. Cancel before delivery.

Console

Scheduled items appear in room context. No separate admin page required.

API

POST /rooms/:roomId/scheduled-messages
GET  /rooms/:roomId/scheduled-messages
DELETE /rooms/:roomId/scheduled-messages/:id

SDK

await client.scheduleMessage(roomId, {
  content: "Reminder: standup in 5 minutes",
  sendAt: new Date(Date.now() + 3600_000).toISOString(),
});

await client.cancelScheduledMessage(roomId, scheduledId);

Related

• Ephemeral messages
• Room firmware