Meetings of a chat room

GET/chat-rooms/:chatRoomId/meetings

Return the meetings linked to a chat room. Used to render meeting controls or a meeting list inside a chat view. Returns 403 when the caller is not a member of the room.

Auth	Login required

Path parameters

chatRoomIdstringrequired

Chat room ID.

Query parameters

includeCanceledstringoptional

Pass true to include canceled meetings. They are excluded by default.

Notes

A direct chat between two users is shared across all events, so several meetings are returned when the same pair meets at more than one event (newest first). Use event to tell them apart.

A meeting whose event.hasEnded is true can no longer be changed because the event is over (changing its status or setting the spot and time returns 400, errorCode 20001).

Response

Field	Type	Description
`meetings`	Meeting[]	Array of meetings, newest first.

Request

curl https://api.4s.link/chat-rooms/CHAT_ROOM_ID/meetings \
  -H "Authorization: Bearer 4s_at_..."

Example response

{
  "meetings": [
    {
      "id": "mt1a2b3c-...",
      "eventId": "ev1a2b3c-...",
      "chatRoomId": "cr1a2b3c-...",
      "status": "REQUESTED"
    }
  ]
}