# Update the properties of the participant

**POST /2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Participants/{CallSid}.json**

Update the properties of the participant
Conference participants

## Servers
- https://api.twilio.com: https://api.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **AccountSid** (string)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Participant resources to update.
- **ConferenceSid** (string)
  The SID of the conference with the participant to update.
- **CallSid** (string)
  The [Call](https://www.twilio.com/docs/voice/api/call-resource) SID or label of the participant to update. Non URL safe characters in a label must be percent encoded, for example, a space character is represented as %20.


### Body: application/x-www-form-urlencoded (object)

- **Muted** (boolean)
  Whether the participant should be muted. Can be `true` or `false`. `true` will mute the participant, and `false` will un-mute them. Anything value other than `true` or `false` is interpreted as `false`.
- **Hold** (boolean)
  Whether the participant should be on hold. Can be: `true` or `false`. `true` puts the participant on hold, and `false` lets them rejoin the conference.
- **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 `<Play>`, `<Say>`, `<Pause>`, or `<Redirect>` verbs.
- **HoldMethod** (string(http-method))
  The HTTP method we should use to call `hold_url`. Can be: `GET` or `POST` and the default is `GET`.
- **AnnounceUrl** (string(uri))
  The URL we call using the `announce_method` for an announcement to the participant. The URL may return an MP3 file, a WAV file, or a TwiML document that contains `<Play>`, `<Say>`, `<Pause>`, or `<Redirect>` verbs.
- **AnnounceMethod** (string(http-method))
  The HTTP method we should use to call `announce_url`. Can be: `GET` or `POST` and defaults to `POST`.
- **WaitUrl** (string(uri))
  The URL that Twilio calls using the `wait_method` before the conference has started. The URL may return an MP3 file, a WAV file, or a TwiML document. The default value is the URL of our standard hold music. If you do not want anything to play while waiting for the conference to start, specify an empty string by setting `wait_url` to `''`. For more details on the allowable verbs within the `waitUrl`, see the `waitUrl` attribute in the [<Conference> TwiML instruction](https://www.twilio.com/docs/voice/twiml/conference#attributes-waiturl).
- **WaitMethod** (string(http-method))
  The HTTP method we should use to call `wait_url`. Can be `GET` or `POST` and the default is `POST`. When using a static audio file, this should be `GET` so that we can cache the file.
- **BeepOnExit** (boolean)
  Whether to play a notification beep to the conference when the participant exits. Can be: `true` or `false`.
- **EndConferenceOnExit** (boolean)
  Whether to end the conference when the participant leaves. Can be: `true` or `false` and defaults to `false`.
- **Coaching** (boolean)
  Whether the participant is coaching another call. Can be: `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** (string)
  The SID of the participant who is being `coached`. The participant being coached is the only participant who can hear the participant who is `coaching`.


## Responses
### 200
OK
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Participant resource.
- **call_sid** (string | null)
  The SID of the [Call](https://www.twilio.com/docs/voice/api/call-resource) the Participant resource is associated with.
- **label** (string | null)
  The user-specified label of this participant, if one was given when the participant was created. This may be used to fetch, update or delete the participant.
- **call_sid_to_coach** (string | null)
  The SID 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 | null)
  Whether the participant is coaching another call. Can be: `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** (string | null)
  The SID of the conference the participant is in.
- **date_created** (string(date-time-rfc-2822) | null)
  The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
- **date_updated** (string(date-time-rfc-2822) | null)
  The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
- **end_conference_on_exit** (boolean | null)
  Whether the conference ends when the participant leaves. Can be: `true` or `false` and the default is `false`. If `true`, the conference ends and all other participants drop out when the participant leaves.
- **muted** (boolean | null)
  Whether the participant is muted. Can be `true` or `false`.
- **hold** (boolean | null)
  Whether the participant is on hold. Can be `true` or `false`.
- **start_conference_on_enter** (boolean | null)
  Whether the conference starts when the participant joins the conference, if it has not already started. Can be: `true` or `false` and the default is `true`. If `false` and the conference has not started, the participant is muted and hears background music until another participant starts the conference.
- **status** (string)
  The status of the participant's call in a session. Can be: `queued`, `connecting`, `ringing`, `connected`, `complete`, or `failed`.
- **queue_time** (string | null)
  The wait time in milliseconds before participant's call is placed. Only available in the response to a create participant request.
- **uri** (string | null)
  The URI of the resource, relative to `https://api.twilio.com`.


[Powered by Bump.sh](https://bump.sh)