REST API: Participants

The Participants list resource is a subresource of a Conference instance resource. It represents the set of participants currently connected to a particular conference. A Participant instance resource represents an individual conference participant.

Participant Instance Resource

This resource represents a single conference participant, identified by a CallSid.

Resource URI

/2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Participants/{CallSid}

Resource Properties

A Participant resource is represented by the following properties:

Property	Description
CallSid	A 34 character string that uniquely identifies the call that is connected to this conference
ConferenceSid	A 34 character string that identifies the conference this participant is in
DateCreated	The date that this resource was created, given in RFC 2822 format.
DateUpdated	The date that this resource was last updated, given in RFC 2822 format.
AccountSid	The unique id of the Account that created this conference
Muted	true if this participant is currently muted. false otherwise.
StartConferenceOnEnter	Was the startConferenceOnEnter attribute set on this participant (true or false)?
EndConferenceOnExit	Was the endConferenceOnExit attribute set on this participant (true or false)?
Uri	The URI for this resource, relative to https://api.twilio.com.

HTTP GET

Returns a representation of this participant:

Example 1

HTTP POST

Updates the status of a participant.

Optional Parameters

You may update the properties of a participant via POSTing the following parameters:

Parameter	Description
Muted	Specifying true will mute the participant, while false will un-mute. Anything other than true or false is interpreted as false.

Example

Mute a participant.

HTTP PUT

Not supported

HTTP DELETE

Kick this participant from the conference. Returns HTTP 204 (No Content), with no body, if the participant was successfully booted from the conference.

Example

Participants List Resource

Resource URI

/2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Participants

HTTP GET

Returns the list of participants in the conference identified by {ConferenceSid}.

List Filters

The following GET query string parameters allow you to limit the list returned. Note, parameters are case-sensitive:

Parameter	Description
Muted	Only show participants that are muted or unmuted. Either true or false.

Example

HTTP POST

Not supported

HTTP PUT

Not supported

HTTP DELETE

Not supported