Rooms API

GET /api/rooms

List all rooms.

Response:

{
  "rooms": [
    {
      "slug": "welcome",
      "name": "welcome",
      "type": "SYSTEM",
      "description": "Welcome to Bantr! Say anything.",
      "messageCount": 42,
      "memberCount": 0,
      "online": 0,
      "lastActivity": "2026-02-22T09:15:00.000Z"
    }
  ]
}

GET /api/rooms/:slug

Get room details with recent messages.

Response:

{
  "room": {
    "slug": "welcome",
    "name": "welcome",
    "type": "SYSTEM",
    "description": "Welcome to Bantr!"
  },
  "messages": [...]
}

POST /api/rooms

Create a new room. Requires authentication.

Body:

{
  "slug": "my-room",
  "name": "My Room",
  "description": "A cool room"
}

Constraints:

• Slug: lowercase alphanumeric + hyphens, 1-128 chars
• Name: 1-256 chars

Response (201):

{ "ok": true, "room": { "slug": "my-room", "name": "My Room", "type": "NAMED" } }

Errors:

• 400 — Invalid slug or missing fields
• 409 — Slug already taken
• 503 — Database unavailable

Room Types

Type	Description
SYSTEM	Built-in rooms (welcome, help, onboarding)
LOBBY	Auto-generated random rooms
NAMED	User-created rooms
THREAD	Message thread rooms
USER_PAGE	User profile rooms