virtualEventSession resource type

2025-03-27

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents a session in a virtualEvent.

Inherits from onlineMeetingBase.

Methods

Method	Return type	Description
List	virtualEventSession collection	Get a list of all virtualEventSession objects under a virtual event.
Get	virtualEventSession	Read the properties and relationships of a virtualEventSession object.

Properties

Property	Type	Description
allowAttendeeToEnableCamera	Boolean	Indicates whether attendees can turn on their camera. Inherited from onlineMeetingBase.
allowAttendeeToEnableMic	Boolean	Indicates whether attendees can turn on their microphone. Inherited from onlineMeetingBase.
allowBreakoutRooms	Boolean	Indicates whether breakout rooms are enabled for the virtual event session. Inherited from onlineMeetingBase.
allowCopyingAndSharingMeetingContent	Boolean	Indicates whether copying and sharing meeting content is enabled for the meeting. Inherited from onlineMeetingBase.
allowedLobbyAdmitters	allowedLobbyAdmitterRoles	Specifies the users who can admit from the lobby. Possible values are: `organizerAndCoOrganizersAndPresenters`, `organizerAndCoOrganizers`, `unknownFutureValue`. Inherited from onlineMeetingBase.
allowedPresenters	onlineMeetingPresenters	Specifies who can be a presenter in a virtual event session. Possible values are: `everyone`, `organization`, `roleIsPresenter`, `organizer`, `unknownFutureValue`. Inherited from onlineMeetingBase.
allowLiveShare	meetingLiveShareOptions	Indicates whether live share is enabled for the virtual event session. Possible values are: `enabled`, `disabled`, `unknownFutureValue`. Inherited from onlineMeetingBase.
allowMeetingChat	meetingChatMode	Specifies the mode of meeting chat. Possible values are: `enabled`, `disabled`, `limited`, `unknownFutureValue`. Inherited from onlineMeetingBase.
allowParticipantsToChangeName	Boolean	Specifies whether participants are allowed to rename themselves in an instance of the meeting. Inherited from onlineMeetingBase.
allowPowerPointSharing	Boolean	Indicates whether PowerPoint live is enabled for the virtual event session. Inherited from onlineMeetingBase.
allowRecording	Boolean	Indicates whether recording is enabled for the virtual event session. Inherited from onlineMeetingBase.
allowTeamworkReactions	Boolean	Indicates whether Teams reactions are enabled for the virtual event session. Inherited from onlineMeetingBase.
allowTranscription	Boolean	Indicates whether transcription is enabled for the virtual event session. Inherited from onlineMeetingBase.
allowWhiteboard	Boolean	Indicates whether whiteboard is enabled for the virtual event session. Inherited from onlineMeetingBase.
anonymizeIdentityForRoles	onlineMeetingRole collection	Specifies whose identity is anonymized in the virtual event session. Possible values are: `attendee`. The `attendee` value can't be removed through a PATCH operation once added. Inherited from onlineMeetingBase.
audioConferencing	audioConferencing	The phone access (dial-in) information for the virtual event session. Read-only. Inherited from onlineMeetingBase.
chatInfo	chatInfo	The chat information associated with the virtual event session. Inherited from onlineMeetingBase.
chatRestrictions	chatRestrictions	Specifies the configuration settings for meeting chat restrictions. Inherited from onlineMeetingBase.
endDateTime	dateTimeTimeZone	The virtual event session end time.
id	String	The unique identifier of the virtual event session. Read-only. Inherited from onlineMeetingBase.
isEndToEndEncryptionEnabled	Boolean	Indicates whether end-to-end encryption (E2EE) is enabled for the virtual event session. Inherited from onlineMeetingBase.
isEntryExitAnnounced	Boolean	Indicates whether to announce when callers join or leave. Inherited from onlineMeetingBase.
joinInformation	itemBody	The join information of the virtual event session. Read-only. Inherited from onlineMeetingBase.
joinMeetingIdSettings	joinMeetingIdSettings	Specifies the joinMeetingId, the meeting passcode, and the requirement for the passcode. Inherited from onlineMeetingBase.
joinWebUrl	String	The join URL of the virtual event session. Read-only. Inherited from onlineMeetingBase.
lobbyBypassSettings	lobbyBypassSettings	Specifies which participants can bypass the meeting lobby. Inherited from onlineMeetingBase.
recordAutomatically	Boolean	Indicates whether to record the virtual event session automatically. Inherited from onlineMeetingBase.
shareMeetingChatHistoryDefault	meetingChatHistoryDefaultMode	Specifies whether meeting chat history is shared with participants. Possible values are: `all`, `none`, `unknownFutureValue`. Inherited from onlineMeetingBase.
startDateTime	DateTimeTimeZone	The virtual event session start time.
subject	String	The subject of the virtual event session. Inherited from onlineMeetingBase.
videoOnDemandWebUrl	String	The URL of the video on demand (VOD) for Microsoft Teams events that allows webinar and town hall organizers to quickly publish and share event recordings.
videoTeleconferenceId	String	The video teleconferencing ID. Read-only. Inherited from onlineMeetingBase.
watermarkProtection	watermarkProtectionValues	Specifies whether the client application should apply a watermark to a content type. Inherited from onlineMeetingBase.

meetingChatHistoryDefaultMode values

Value	Description
all	All meeting chat history is shared.
none	No meeting chat history is shared.
unknownFutureValue	Evolvable enumeration sentinel value. Don't use.

meetingChatMode values

Value	Description
enabled	Meeting chat is enabled.
disabled	Meeting chat is disabled.
limited	Meeting chat is enabled but only during the meeting call.
unknownFutureValue	Evolvable enumeration sentinel value. Don't use.

meetingLiveShareOptions values

Value	Description
enabled	Meeting live share is enabled.
disabled	Meeting live share is disabled.
unknownFutureValue	Evolvable enumeration sentinel value. Don't use.

onlineMeetingPresenters values

Value	Description
everyone	Everyone is a presenter. Default.
organization	Everyone in organizer’s organization is a presenter.
roleIsPresenter	Only the participants whose role is presenter are presenters.
organizer	Only the organizer is a presenter.
unknownFutureValue	Evolvable enumeration sentinel value. Don't use.

Relationships

Relationship	Type	Description
attendanceReports	meetingAttendanceReport collection	Attendance reports of this virtual event session. Inherited from onlineMeetingBase.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.virtualEventSession",
  "allowAttendeeToEnableCamera": "Boolean",
  "allowAttendeeToEnableMic": "Boolean",
  "allowBreakoutRooms": "Boolean",
  "allowCopyingAndSharingMeetingContent": "Boolean",
  "allowedLobbyAdmitters": "String",
  "allowedPresenters": "String",
  "allowLiveShare": "String",
  "allowMeetingChat": "String",
  "allowParticipantsToChangeName": "Boolean",
  "allowPowerPointSharing": "Boolean",
  "allowRecording": "Boolean",
  "allowTeamworkReactions": "Boolean",
  "allowTranscription": "Boolean",
  "allowWhiteboard": "Boolean",
  "anonymizeIdentityForRoles": ["String"],
  "audioConferencing": {"@odata.type": "microsoft.graph.audioConferencing"},
  "chatInfo": {"@odata.type": "microsoft.graph.chatInfo"},
  "chatRestrictions":{"@odata.type": "microsoft.graph.chatRestrictions"},
  "endDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "id": "String (identifier)",
  "isEndToEndEncryptionEnabled": "Boolean",
  "isEntryExitAnnounced": "Boolean",
  "joinInformation": {"@odata.type": "microsoft.graph.itemBody"},
  "joinMeetingIdSettings": {"@odata.type": "microsoft.graph.joinMeetingIdSettings"},
  "joinWebUrl": "String",
  "lobbyBypassSettings": {"@odata.type": "microsoft.graph.lobbyBypassSettings"},
  "recordAutomatically": "Boolean",
  "shareMeetingChatHistoryDefault": "String",
  "startDateTime": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "subject": "String",
  "videoOnDemandWebUrl": "String",
  "videoTeleconferenceId": "String",
  "watermarkProtection": {"@odata.type": "microsoft.graph.watermarkProtectionValues"}
}

List meetingAttendanceReports