Help Center/ Meeting/ Server API Reference/ Meeting Control/ APIs/ Raising Hands
Updated on 2023-12-22 GMT+08:00
Online Debugging
CLI Examples
View PDF

Raising Hands

Description

This API is used to configure the hand-raising status of guests in batches.

Debugging

You can debug this API in API Explorer.

URI

PUT /v1/mmc/control/conferences/participants/batch/hands

Table 1 Query parameter

Parameter

Mandatory

Type

Description

conferenceID

Yes

String

Meeting ID.

Request Parameters

Table 2 Request header parameter

Parameter

Mandatory

Type

Description

X-Conference-Authorization

Yes

String

Meeting control token, which can be obtained by calling the API for Obtaining a Meeting Control Token.
Table 3 Request body parameters

Parameter

Mandatory

Type

Description

handsState

Yes

Integer

  • 0: Lower hands.

  • 1: Raise hands.

pids

Yes

Array of strings

Participant ID list.

Response Parameters

Status code: 400

Table 4 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Request

PUT https://{endpoint}/v1/mmc/control/conferences/participants/batch/hands?conferenceID=914376690

{
  "handsState" : 1,
  "pids" : [ "af50e9e63b4111ea9668df997d1c89da", "cf50e9e63b41e63b49697d197d11ea9d" ]
}

Example Response

Status code: 400

Invalid parameters.

{
  "error_code" : "MMC.111072065",
  "error_msg" : "CONF_NOT_FOUND_OR_AUTH_FAILED"
}

Status Codes

Status Code

Description

200

Operation successful.

400

Invalid parameters.

Error Codes

If an error code starting with MMC or USG is returned when you use this API, rectify the fault by following the instructions provided in Huawei Cloud API Error Center.

Parent topic: APIs