Latest Legacy

    Disconnect a member from a conference

    This method lets you disconnect a member in a conference. When the member is disconnected, the next action to be performed depends on the next element in the XML.

    API Endpoint

    POST https://api.plivo.com/v1/Account/{auth_id}/Conference/{conference_name}/Member/{member_id}/Kick/


    Here’s an example. If the XML code below starts the conference, Plivo will play the text in the <Speak> tag after the member is disconnected.

    <Response>
    <Conference enterSound="beep:1">MyConference</Conference>
    <Speak>You have been disconnected from the conference</Speak>
</Response>

    The member_id attribute that’s passed in the URL can be either a member_id or the string all. In the latter case, the disconnect action is performed on all members of the conference.

    Attributes

    No arguments need to be passed.

    Returns

    Returns an acknowledgement that the member has been disconnected from the conference.

    Response

    HTTP Status Code: 202

    {
  "message": "kicked",
  "member_id": "10",
  "api_id": "2867b6e2-58c3-11e1-86da-adf28403fe48"
}