Skip to main content

Update a Participant

POST 

/Accounts/:AccountSid/Conferences/:ConferenceSid/Participants/:CallSid

Allows you to modify the properties of participant in an active conference call.

Permissions

The API token must include the following scopes: Voice.

Request

Path Parameters

    AccountSid uuidrequired

    The unique identifier for the account that created this conference.

    ConferenceSid uuidrequired

    The unique identifier for the conference this participant is in.

    CallSid uuidrequired

    The unique identifier for the Participant call connected to this conference.

Body

required

    AnnounceUrl string

    The URL to send participant announcements to.

    AnnounceMethod string

    Possible values: [GET, POST]

    Whether the request to AnnounceUrl is a GET or a POST. Default is POST.

    Beep boolean

    Whether or not ot play the beep sound when updating the Participant.

    Coaching boolean

    Whether the participant is coaching another call. Possible values are true or false. If not present, defaults to false unless call_sid_to_coach is defined. If true, call_sid_to_coach must be defined.

    CallSidToCoach uuid

    The unique identifier of the participant who is being coached. The participant being coached is the only participant who can hear the participant who is coaching.

    Hold boolean

    Whether or not a participant is on hold. Possible values are true or false.

    HoldMethod string

    Possible values: [GET, POST]

    Whether the request to HoldUrl is a GET or a POST. Default is POST.

    HoldUrl string

    The URL to send hold music to that will be played when participant is on hold.

    Muted boolean

    Whether or not a participant is muted. Possible values are true or false.

Responses

OK

Schema

    account_sid uuid

    The unique identifier for the account that created this conference.

    call_sid uuid

    The unique identifier for the Participant call connected to this conference.

    call_sid_to_coach uuid

    The unique identifier of the participant who is being coached. The participant being coached is the only participant who can hear the participant who is coaching.

    coaching boolean

    Whether the participant is coaching another call. Possible values are true or false. If not present, defaults to false unless call_sid_to_coach is defined. If true, call_sid_to_coach must be defined.

    conference_sid uuid

    The unique identifier for the conference this participant is in.

    date_created string

    The date, in RFC 2822 format, this conference participant was created.

    status string

    Possible values: [completed, in-progress]

    The status of the conference call (?)

    date_updated string

    The date, in RFC 2822 format, this conference participant was updated.

    end_conference_on_exit boolean

    Whether or not a conference ends when a participant leaves the conference call. Possible values are true or false.

    muted boolean

    Whether or not a participant is muted. Possible values are true or false.

    hold boolean

    Whether or not a participant is on hold. Possible values are true or false.

    start_conference_on_enter boolean

    Whether or not a conference will begin when this participant enters the conference call. Possible values are true or false.

    uri string

    The URI for this conference participant.

Loading...