Help Center/ Meeting/ Server API Reference/ Meeting Management/ APIs/ Canceling a Scheduled Meeting
Updated on 2023-12-22 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Canceling a Scheduled Meeting

Description

This API is used to cancel a scheduled meeting. An enterprise administrator can cancel meetings created by users in the enterprise. Common users can cancel only meetings created by themselves.

Debugging

You can debug this API in API Explorer.

Prototype

Table 1 Prototype

Request Method

DELETE

Request Address

/v1/mmc/management/conferences

Transport Protocol

HTTPS

Request Parameters

Table 2 Parameters

Parameter

Mandatory

Type

Location

Description

conferenceID

Yes

String

Query

Meeting ID.

NOTE:

conferenceID returned when a meeting is created. The value is not the value of vmrConferenceID.

userUUID

No

String

Query

UUID of a user.

NOTE:

This parameter will be discarded. Do not use it.

type

No

Integer

Query

Operation type of canceling a meeting. By default, a meeting that has been held cannot be canceled.

  • 1: Cancel an ongoing meeting.

X-Access-Token

Yes

String

Header

Authorization token. Use the value of accessToken in the response to the request for Authenticating an App ID.

X-Authorization-Type

No

String

Header

Whether the request is sent from a third-party portal.

NOTE:

This parameter will be discarded. Do not use it.

X-Site-Id

No

String

Header

ID of the HCS Online site where the authentication is performed.

NOTE:

This parameter will be discarded. Do not use it.

Status Codes

Table 3 Status codes

HTTP Status Code

Description

200

Operation successful.

401

Authentication is not performed or fails.

403

Insufficient permissions.

500

Server exception.

Response Parameters

None

Example Request

DELETE /v1/mmc/management/conferences?conferenceID=914087436
Connection: keep-alive
X-Access-Token: stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC
user-agent: WeLink-desktop
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

Example Response

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 39
Connection: keep-alive
http_proxy_id: 40c9d32a92b43f85e5cd12617b49535b
Server: api-gateway
X-Request-Id: a02164ff20cbc841c6c0e9ab38a07e5b

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.

Example cURL Command

curl -k -i -X DELETE -H 'X-Access-Token:stbX5ElstO5QwOwPB9KGQWUZ1DHoFrTsQjjC' 'https://api.meeting.huaweicloud.com/v1/mmc/management/conferences?conferenceID=914087436'
Parent topic: APIs