From d390d3bec3b0efddf580a4e45c527430b1c4c830 Mon Sep 17 00:00:00 2001 From: Joas Schilling Date: Wed, 7 Dec 2022 14:55:48 +0100 Subject: Allow to "Request assistance" and reset it Signed-off-by: Joas Schilling --- docs/breakout-rooms.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) (limited to 'docs') diff --git a/docs/breakout-rooms.md b/docs/breakout-rooms.md index 8bd689cd8..58cf124fb 100644 --- a/docs/breakout-rooms.md +++ b/docs/breakout-rooms.md @@ -93,3 +93,27 @@ Group and public conversations can be used to host breakout rooms. + `403 Forbidden` When the participant is not a moderator + `404 Not Found` When the conversation could not be found for the participant + `413 Payload Too Large` When the message was longer than the allowed limit of 32000 characters (check the `spreed => config => chat => max-length` capability for the limit) + +## Request assistance + +This endpoint allows participants to raise their hand (token is the breakout room) and moderators will see it in any of the breakout rooms as well as the parent room. + +* Required capability: `breakout-rooms-v1` +* Method: `POST` +* Endpoint: `/breakout-rooms/{token}/request-assistance` +* Response: + - Status code: + + `200 OK` + + `400 Bad Request` When the room is not a breakout room or breakout rooms are not started + + `404 Not Found` When the conversation could not be found for the participant + +## Reset request for assistance + +* Required capability: `breakout-rooms-v1` +* Method: `DELETE` +* Endpoint: `/breakout-rooms/{token}/request-assistance` +* Response: + - Status code: + + `200 OK` + + `400 Bad Request` When the room does not have breakout rooms configured + + `404 Not Found` When the conversation could not be found for the participant -- cgit v1.2.3