Update the properties of the participant
Conference participants
Update the properties of the participant
Body
-
AnnounceMethod string(http-method)
The HTTP method we should use to call
announce_url
. Can be:GET
orPOST
and defaults toPOST
.Values are
HEAD
,GET
,POST
,PATCH
,PUT
, orDELETE
. -
AnnounceUrl string(uri)
The URL we call using the
announce_method
for an announcement to the participant. The URL must return an MP3 file, a WAV file, or a TwiML document that contains<Play>
or<Say>
commands. -
BeepOnExit boolean
Whether to play a notification beep to the conference when the participant exits. Can be:
true
orfalse
. -
CallSidToCoach string
The SID of the participant who is being
coached
. The participant being coached is the only participant who can hear the participant who iscoaching
.Minimum length is
34
, maximum length is34
. Format should match the following pattern:^CA[0-9a-fA-F]{32}$
. -
Coaching boolean
Whether the participant is coaching another call. Can be:
true
orfalse
. If not present, defaults tofalse
unlesscall_sid_to_coach
is defined. Iftrue
,call_sid_to_coach
must be defined. -
EndConferenceOnExit boolean
Whether to end the conference when the participant leaves. Can be:
true
orfalse
and defaults tofalse
. -
Hold boolean
Whether the participant should be on hold. Can be:
true
orfalse
.true
puts the participant on hold, andfalse
lets them rejoin the conference. -
HoldMethod string(http-method)
The HTTP method we should use to call
hold_url
. Can be:GET
orPOST
and the default isGET
.Values are
HEAD
,GET
,POST
,PATCH
,PUT
, orDELETE
. -
HoldUrl string(uri)
The URL we call using the
hold_method
for music that plays when the participant is on hold. The URL may return an MP3 file, a WAV file, or a TwiML document that contains the<Play>
,<Say>
or<Redirect>
commands. -
Muted boolean
Whether the participant should be muted. Can be
true
orfalse
.true
will mute the participant, andfalse
will un-mute them. Anything value other thantrue
orfalse
is interpreted asfalse
. -
WaitMethod string(http-method)
The HTTP method we should use to call
wait_url
. Can beGET
orPOST
and the default isPOST
. When using a static audio file, this should beGET
so that we can cache the file.Values are
HEAD
,GET
,POST
,PATCH
,PUT
, orDELETE
. -
WaitUrl string(uri)
The URL we should call using the
wait_method
for the music to play while participants are waiting for the conference to start. The default value is the URL of our standard hold music. Learn more about hold music.
curl \
-X POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Participants/{CallSid}.json \
--user "username:password" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d 'AnnounceMethod=HEAD&AnnounceUrl=https%3A%2F%2Fexample.com&BeepOnExit=true&CallSidToCoach=string&Coaching=true&EndConferenceOnExit=true&Hold=true&HoldMethod=HEAD&HoldUrl=https%3A%2F%2Fexample.com&Muted=true&WaitMethod=HEAD&WaitUrl=https%3A%2F%2Fexample.com'
{
"AnnounceMethod": "HEAD",
"AnnounceUrl": "https://example.com",
"BeepOnExit": true,
"CallSidToCoach": "string",
"Coaching": true,
"EndConferenceOnExit": true,
"Hold": true,
"HoldMethod": "HEAD",
"HoldUrl": "https://example.com",
"Muted": true,
"WaitMethod": "HEAD",
"WaitUrl": "https://example.com"
}
{
"AnnounceMethod": "HEAD",
"AnnounceUrl": "https://example.com",
"BeepOnExit": true,
"CallSidToCoach": "string",
"Coaching": true,
"EndConferenceOnExit": true,
"Hold": true,
"HoldMethod": "HEAD",
"HoldUrl": "https://example.com",
"Muted": true,
"WaitMethod": "HEAD",
"WaitUrl": "https://example.com"
}
{
"account_sid": "string",
"call_sid": "string",
"call_sid_to_coach": "string",
"coaching": true,
"conference_sid": "string",
"date_created": "string",
"date_updated": "string",
"end_conference_on_exit": true,
"hold": true,
"label": "string",
"muted": true,
"start_conference_on_enter": true,
"status": "queued",
"uri": "string"
}
{
"account_sid": "string",
"call_sid": "string",
"call_sid_to_coach": "string",
"coaching": true,
"conference_sid": "string",
"date_created": "string",
"date_updated": "string",
"end_conference_on_exit": true,
"hold": true,
"label": "string",
"muted": true,
"start_conference_on_enter": true,
"status": "queued",
"uri": "string"
}