Conference Participants

Retrieve a Participant

Retrieves one active voice-conference participant by the call SID used to join the conference. Use List all active Participants to discover Call SIDs; this operation does not retrieve Video Room participants.

Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: Voice.

Learn more about API scopes.

get/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Participants/{CallSid}

Path parameters

AccountSidstring uuid required

Universal Unique Identifier.

The unique identifier for the account that created this conference.

ConferenceSidstring uuid required

Universal Unique Identifier.

The unique identifier for the conference this participant is in.

CallSidstring uuid required

Universal Unique Identifier.

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

Response

The request has succeeded.

account_sidstring uuid required

Universal Unique Identifier.

call_sidstring uuid required

Universal Unique Identifier.

call_sid_to_coachstring uuid required

Universal Unique Identifier.

coachingboolean required

Whether the participant is coaching another call.

conference_sidstring uuid required

Universal Unique Identifier.

date_createdstring required

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

status'completed' | 'in-progress' required

Conference participant status.

date_updatedstring required

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

end_conference_on_exitboolean required

Whether or not a conference ends when a participant leaves the conference call.

mutedboolean required

Whether or not a participant is muted.

holdboolean required

Whether or not a participant is on hold.

start_conference_on_enterboolean required

Whether or not a conference will begin when this participant enters the conference call.

uristring required

The URI for this conference participant.

Example response

{
  "date_created": "Mon, 24 Sept 2018 21:00:00 +0000",
  "date_updated": "Tue, 25 Sept 2018 20:00:00 +0000",
  "start_conference_on_enter": true,
  "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Conferences/b3877c40-da60-4998-90ad-b792e98472cf/Participants/b3877c40-da60-4998-90ad-b792e98472ca.json"
}

Changes

Changed in 6 of the 40 revisions of this API.1128

  • 2916d5e3072e45See the full diff
    • the response's property type changed from string to no type, and format from uuid to no format for status

      response-property-type-changed

    • the response's property type changed from string to no type, and format from uuid to no format for status

      response-property-type-changed

    • the response's property format changed from uuid to no format for status

      response-property-type-changed

    • the response's property type changed from string to no type, and format from uuid to no format for status

      response-property-type-changed

    • added to the response property allOf list for the response status

      response-property-all-of-added

    • added to the response property allOf list for the response status

      response-property-all-of-added

    • added to the response property allOf list for the response status

      response-property-all-of-added

    • added to the response property anyOf list for the response status

      response-property-any-of-added

    • removed subschema #1 from the response property anyOf list for the response status

      response-property-any-of-removed

    • added 'unevaluatedProperties' constraint to the response body for the status

      response-body-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the response body for the status

      response-body-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the response body for the status

      response-body-unevaluated-properties-added

    • added 'unevaluatedProperties' constraint to the response body for the status

      response-body-unevaluated-properties-added

    • response property call_sid_to_coach list-of-types was widened by adding types null to media type application/json of response 200

      response-property-list-of-types-widened

  • d5fbaaddfa3e114See the full diff
    • the response property became nullable for the status

      response-property-became-nullable

    • added the non-success response with the status

      response-non-success-status-added

    • the response property became required for the status

      response-property-became-required

    • the response property became required for the status

      response-property-became-required

    • the response property became required for the status

      response-property-became-required

    • the response property became required for the status

      response-property-became-required

    • the response property became required for the status

      response-property-became-required

    • the response property became required for the status

      response-property-became-required

    • the response property became required for the status

      response-property-became-required

    • the response property became required for the status

      response-property-became-required

    • the response property became required for the status

      response-property-became-required

    • the response property became required for the status

      response-property-became-required

    • the response property became required for the status

      response-property-became-required

    • the response property became required for the status

      response-property-became-required

    • the response property became required for the status

      response-property-became-required

    This revision also has 11 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • the response property became nullable for the status

      response-property-became-nullable

  • 3c88f14db21e45See the full diff
    • added the new path request parameter AccountSid

      new-request-path-parameter

    • added the new path request parameter CallSid

      new-request-path-parameter

    • added the new path request parameter ConferenceSid

      new-request-path-parameter

    • the response's property type changed from string to no type for status

      response-property-type-changed

    • added the non-success response with the status

      response-non-success-status-added

    • added the non-success response with the status

      response-non-success-status-added

    • added to the response property allOf list for the response status

      response-property-all-of-added

    • removed the completed enum value from the response property for the response status

      response-property-enum-value-removed

    • removed the in-progress enum value from the response property for the response status

      response-property-enum-value-removed

    This revision also has 14 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog