Help Center/ Meeting/ Server API Reference/ Meeting Control/ APIs/ Applying to Be a Co-Host
Updated on 2023-12-22 GMT+08:00
Online Debugging
CLI Examples
View PDF

Applying to Be a Co-Host

Description

This API is used to assign or relinquish the co-host role. Only guests can be set as co-hosts.

Debugging

You can debug this API in API Explorer.

URI

PUT /v1/mmc/control/conferences/participants/cohost

Table 1 Query parameters

Parameter

Mandatory

Type

Description

conferenceID

Yes

String

Meeting ID.

participantID

Yes

String

Participant 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 parameter

Parameter

Mandatory

Type

Description

isCohost

Yes

Integer

  • 0: Relinquish the co-host role.

  • 1: Assign the co-host role.

Minimum value: 0

Maximum value: 1

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/cohost?conferenceID=914346822&participantID=b4fff28653da11eab6b7e73d6691f26c

{
  "isCohost" : 1
}

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