InsightsV1Conference

Get a specific Conference Summary.

get/v1/Conferences/{ConferenceSid}

Path parameters

ConferenceSidstring required

The unique SID identifier of the Conference.

Response

conference_sidstring nullable

The unique SID identifier of the Conference.

account_sidstring nullable

The unique SID identifier of the Account.

friendly_namestring nullable

Custom label for the conference resource, up to 64 characters.

create_timestring date-time nullable

Conference creation date and time in ISO 8601 format.

start_timestring date-time nullable

Timestamp in ISO 8601 format when the conference started. Conferences do not start until at least two participants join, at least one of whom has startConferenceOnEnter=true.

end_timestring date-time nullable

Conference end date and time in ISO 8601 format.

duration_secondsinteger nullable

Conference duration in seconds.

connect_duration_secondsinteger nullable

Duration of the between conference start event and conference end event in seconds.

status'in_progress' | 'not_started' | 'completed' | 'summary_timeout'

max_participantsinteger nullable

Maximum number of concurrent participants as specified by the configuration.

max_concurrent_participantsinteger nullable

Actual maximum number of concurrent participants in the conference.

unique_participantsinteger nullable

Unique conference participants based on caller ID.

end_reason'last_participant_left' | 'conference_ended_via_api' | 'participant_with_end_conference_on_exit_left' | 'last_participant_kicked' | 'participant_with_end_conference_on_exit_kicked'

ended_bystring nullable

Call SID of the participant whose actions ended the conference.

mixer_region'us1' | 'us2' | 'au1' | 'br1' | 'ie1' | 'jp1' | 'sg1' | 'de1' | 'in1'

mixer_region_requested'us1' | 'us2' | 'au1' | 'br1' | 'ie1' | 'jp1' | 'sg1' | 'de1' | 'in1'

recording_enabledboolean nullable

Boolean. Indicates whether recording was enabled at the conference mixer.

{"stackTrail":"components:schemas:insights.v1.conference:properties:detected_issues","oasType":"schema","type":"unknown","description":"Potential issues detected by Twilio during the conference.","nullable":true}

tagsConferenceEnumTag[] nullable

Tags for detected conference conditions and participant behaviors which may be of interest.

{"stackTrail":"components:schemas:insights.v1.conference:properties:tag_info","oasType":"schema","type":"unknown","description":"Object. Contains details about conference tags including severity.","nullable":true}

processing_state'complete' | 'in_progress' | 'timeout'

urlstring uri nullable

The URL of this resource.

linksobject nullable

Contains a dictionary of URL links to nested resources of this Conference.

Changes

Changed in 5 of the 51 revisions of this API.451

Aug 18, 2025v10c1d9c8a04412See the full diff
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
- ▲
  the response's property type changed from object to no type for status
  response-property-type-changed
Mar 11, 2025v1b62ede4d8adc22See the full diff
- ▲
  the response's property type changed from no type to object for status
  response-property-type-changed
- ▲
  the response's property type changed from no type to object for status
  response-property-type-changed
- ●
  added the new in1 enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new in1 enum value to the response property for the response status
  response-property-enum-value-added
Jan 28, 2025v1292f819049d22See the full diff
- ●
  added the new us2 enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new us2 enum value to the response property for the response status
  response-property-enum-value-added
Nov 15, 2024v13452354c496b1See the full diff
- ●
  added the new no_concurrent_participants enum value to the / response property for the response status
  response-property-enum-value-added
Aug 10, 2023v1fd83d6640ffd1See the full diff
- ○
  api tag InsightsV1Conference added
  api-tag-added

Full history