Microsoft Graph: Online meetings, calls and presence
Create Teams online meetings, read attendance reports, recordings and transcripts, read call records, place and manage calls from a bot, and read or set…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Create Teams online meetings, read attendance reports, recordings and transcripts, read call records, place and manage calls from a bot, and read or set presence.
This listing is one area of Microsoft Graph, the single REST API for Microsoft 365, Outlook, OneDrive, Teams and Microsoft Entra ID. It holds 291 of the area's requests, the most direct ones first, generated from Microsoft's own OpenAPI description of Graph v1.0. The other areas (mail, calendar, files, Teams, users and more) are listed separately on the Microsoft page.
Get an access token
- Sign in to the Microsoft Entra admin center and open App registrations > New registration. For a quick test, the Graph Explorer signs you in and shows a token without registering anything.
- Under API permissions, add the Microsoft Graph permissions this area needs, for example:
OnlineMeetings.ReadWrite,Presence.Read.All,CallRecords.Read.All. Delegated permissions act as the signed-in user; application permissions act as the app itself and need an administrator's consent. - Under Certificates & secrets, create a client secret (keep it out of shared collections).
- Get a token from
https://login.microsoftonline.com/ /oauth2/v2.0/token: the authorization-code flow for a user, orgrant_type=client_credentialswithscope=https://graph.microsoft.com/.defaultfor an app. Send it asAuthorization: Bearer.
Using these requests
- Base URL:
https://graph.microsoft.com/v1.0./me/...paths act on the signed-in user; with an application token use/users/{id or userPrincipalName}/...instead. - Shape responses with OData query parameters:
$select(fields),$filter,$orderby,$top,$expandand$search(some need theConsistencyLevel: eventualheader). Long lists are paged: follow@odata.nextLink. - Combine up to 20 requests in one call with
POST /$batch.
Common errors
| Status | Code | What to do |
|---|---|---|
| 401 | InvalidAuthenticationToken | The token is missing, expired or for another resource: get a new one for https://graph.microsoft.com. |
| 403 | Authorization_RequestDenied / ErrorAccessDenied | Add the permission listed in the request's docs and grant consent. |
| 404 | ResourceNotFound / itemNotFound | Check the id; ids from another user or tenant are not found. |
| 429 | TooManyRequests | Throttled: wait the Retry-After seconds, then retry. |
Docs: Online meetings, calls and presence overview · Permissions reference · Throttling
Endpoints 291
Online meetings
- GETList online meetings
/me/onlineMeetingsRetrieve the properties and relationships of an onlineMeeting object. For example, you can: Teams live event attendee report (deprecated) and Teams live event… - POSTCreate online meeting
/me/onlineMeetingsCreate an online meeting on behalf of a user. - POSTCreate or get (online meeting)
/me/onlineMeetings/createOrGetCreate an onlineMeeting object with a custom specified external ID. If the external ID already exists, this API will return the onlineMeeting object with that… - GETGet all recordings (online meeting)
/me/onlineMeetings/getAllRecordings(meetingOrganizerUserId='@meetingOrganizerUserId',startDateTime=@startDateTime,endDateTime=@endDateTime)Get all recordings from scheduled onlineMeeting instances for which the specified user is the organizer. This API currently doesn't support getting call… - GETGet all transcripts (online meeting)
/me/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='@meetingOrganizerUserId',startDateTime=@startDateTime,endDateTime=@endDateTime)Get all transcripts from scheduled onlineMeeting instances for which the specified user is the organizer. This API currently doesn't support getting call… - GETGet online meeting
/me/onlineMeetings/:onlineMeeting-idRetrieve the properties and relationships of an onlineMeeting object. For example, you can: Teams live event attendee report (deprecated) and Teams live event… - DELETEDelete online meeting
/me/onlineMeetings/:onlineMeeting-idDelete an onlineMeeting object. - PATCHUpdate online meeting
/me/onlineMeetings/:onlineMeeting-idUpdate the properties of the specified onlineMeeting object. For the list of properties that support updating, see the Request body section. - POSTSend virtual appointment sms (online meeting)
/me/onlineMeetings/:onlineMeeting-id/sendVirtualAppointmentSmsSend an SMS notification to external attendees when a Teams virtual appointment is confirmed, rescheduled, or canceled. This feature requires Teams premium.… - GETGet virtual appointment join web url (online meeting)
/me/onlineMeetings/:onlineMeeting-id/getVirtualAppointmentJoinWebUrl()Get a join web URL for a Microsoft Virtual Appointment. This web URL includes enhanced business-to-customer experiences such as mobile browser join and… - POSTSend virtual appointment reminder sms (online meeting)
/me/onlineMeetings/:onlineMeeting-id/sendVirtualAppointmentReminderSmsSend an SMS reminder to external attendees for a Teams virtual appointment. This feature requires Teams premium and attendees must have a valid United States…
Online meetings: recordings
- GETList recordings
/me/onlineMeetings/:onlineMeeting-id/recordingsGet a callRecording object associated with a scheduled online meeting and an ad hoc call. This API supports the retrieval of call recordings from all meeting… - POSTCreate recording
/me/onlineMeetings/:onlineMeeting-id/recordings - GETTrack changes to recordings (delta)
/me/onlineMeetings/:onlineMeeting-id/recordings/delta() - GETGet recording
/me/onlineMeetings/:onlineMeeting-id/recordings/:callRecording-idThe recordings of an online meeting. Read-only. - DELETEDelete recording
/me/onlineMeetings/:onlineMeeting-id/recordings/:callRecording-id - PATCHUpdate recording
/me/onlineMeetings/:onlineMeeting-id/recordings/:callRecording-id - GETDownload recording content
/me/onlineMeetings/:onlineMeeting-id/recordings/:callRecording-id/contentThe content of the recording. Read-only. - PUTUpload recording content
/me/onlineMeetings/:onlineMeeting-id/recordings/:callRecording-id/contentThe content of the recording. Read-only. - DELETEUpload recording content
/me/onlineMeetings/:onlineMeeting-id/recordings/:callRecording-id/contentThe content of the recording. Read-only.
Online meetings: transcripts
- GETList transcripts
/me/onlineMeetings/:onlineMeeting-id/transcriptsThe transcripts of an online meeting. Read-only. - POSTCreate transcript
/me/onlineMeetings/:onlineMeeting-id/transcripts - GETTrack changes to transcripts (delta)
/me/onlineMeetings/:onlineMeeting-id/transcripts/delta() - GETGet transcript
/me/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-idThe transcripts of an online meeting. Read-only. - DELETEDelete transcript
/me/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id - PATCHUpdate transcript
/me/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id - GETDownload transcript content
/me/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id/contentThe content of the transcript. Read-only. - PUTUpload transcript content
/me/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id/contentThe content of the transcript. Read-only. - DELETEUpload transcript content
/me/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id/contentThe content of the transcript. Read-only. - GETGet metadata content
/me/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id/metadataContentThe time-aligned metadata of the utterances in the transcript. Read-only. - PUTReplace metadata content
/me/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id/metadataContentThe time-aligned metadata of the utterances in the transcript. Read-only. - DELETEDelete metadata content
/me/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id/metadataContentThe time-aligned metadata of the utterances in the transcript. Read-only.
Online meetings: attendee report
- GETGet attendee report
/me/onlineMeetings/:onlineMeeting-id/attendeeReportRetrieve the properties and relationships of an onlineMeeting object. For example, you can: Teams live event attendee report (deprecated) and Teams live event… - PUTReplace attendee report
/me/onlineMeetings/:onlineMeeting-id/attendeeReportThe content stream of the attendee report of a Microsoft Teams live event. Read-only. - DELETEDelete attendee report
/me/onlineMeetings/:onlineMeeting-id/attendeeReportThe content stream of the attendee report of a Microsoft Teams live event. Read-only.
Online meetings: attendance reports
- GETList attendance reports
/me/onlineMeetings/:onlineMeeting-id/attendanceReportsGet a list of meetingAttendanceReport objects for an onlineMeeting or a virtualEvent. Each time an online meeting or a virtual event ends, an attendance… - POSTCreate attendance report
/me/onlineMeetings/:onlineMeeting-id/attendanceReports - GETGet attendance report
/me/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-idGet the meetingAttendanceReport for an onlineMeeting or a virtualEvent. When an online meeting ends, an attendance report is generated for that session. - DELETEDelete attendance report
/me/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id - PATCHUpdate attendance report
/me/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id - GETList attendance records
/me/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id/attendanceRecordsGet a list of attendanceRecord objects and their properties. - POSTCreate attendance record
/me/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id/attendanceRecords - GETGet attendance record
/me/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id/attendanceRecords/:attendanceRecord-idList of attendance records of an attendance report. Read-only. - DELETEDelete attendance record
/me/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id/attendanceRecords/:attendanceRecord-id - PATCHUpdate attendance record
/me/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id/attendanceRecords/:attendanceRecord-id
Presence
- GETGet presence
/me/presenceGet a user's presence information. - DELETEDelete presence
/me/presence - PATCHUpdate presence
/me/presence - POSTSet presence (presence)
/me/presence/setPresenceSet the state of a user's presence session as an application. For more information about presence sessions, states permutations, and timeouts, see Manage… - POSTClear location (presence)
/me/presence/clearLocationClear the work location signals for a user, including both the manual and automatic layers for the current date. - POSTClear presence (presence)
/me/presence/clearPresenceClear the application's presence session for a user. If it is the user's only presence session, the user's presence will change to Offline/Offline. For… - POSTSet status message (presence)
/me/presence/setStatusMessageSet a presence status message for a user. An optional expiration date and time can be supplied. - POSTSet manual location (presence)
/me/presence/setManualLocationSet the manual work location signal for a user. The explicit value chosen by a user or an authorized client overrides any automatically detected or scheduled… - POSTSet automatic location (presence)
/me/presence/setAutomaticLocationUpdate the automatic work location for a user. The automatic layer participates in the standard precedence model: Use this operation from clients or services… - POSTClear automatic location (presence)
/me/presence/clearAutomaticLocationClear the automatic work location signal for a user. After clearing, the user’s final aggregated work location is recomputed according to the precedence… - POSTSet user preferred presence (presence)
/me/presence/setUserPreferredPresenceSet the preferred availability and activity status for a user. If the preferred presence of a user is set, the user's presence shows as the preferred status.… - POSTClear user preferred presence (presence)
/me/presence/clearUserPreferredPresenceClear the preferred availability and activity status for a user.
Communications
- GETList communications
/communications - PATCHUpdate communications
/communications - POSTGet presences by user id (communication)
/communications/getPresencesByUserIdGet the presence information for multiple users. - GETGet all online meeting messages (communication)
/communications/getAllOnlineMeetingMessages()Get all Teams question and answer (Q&A) conversation messages in a tenant. This function returns a snapshot of all Q&A activity in JSON format. The export…
Adhoc calls
- GETList adhoc calls
/me/adhocCallsAd hoc calls associated with the user. Read-only. Nullable. - POSTCreate adhoc call
/me/adhocCalls - GETGet all recordings (adhoc call)
/me/adhocCalls/getAllRecordings(userId='@userId',startDateTime=@startDateTime,endDateTime=@endDateTime) - GETGet all transcripts (adhoc call)
/me/adhocCalls/getAllTranscripts(userId='@userId',startDateTime=@startDateTime,endDateTime=@endDateTime) - GETGet adhoc call
/me/adhocCalls/:adhocCall-idAd hoc calls associated with the user. Read-only. Nullable. - DELETEDelete adhoc call
/me/adhocCalls/:adhocCall-id - PATCHUpdate adhoc call
/me/adhocCalls/:adhocCall-id
Communications: calls
- GETList calls
/communications/callsRetrieve the properties and relationships of a call object. - POSTCreate call
/communications/callsCreate call enables your bot to create a new outgoing peer-to-peer or group call, or join an existing meeting. You need to register the calling bot and go… - POSTCreate log teleconference device quality
/communications/calls/logTeleconferenceDeviceQualityLog video teleconferencing device quality data. The Cloud Video Interop (CVI) bot represents video teleconferencing (VTC) devices and acts as a back-to-back… - GETGet call
/communications/calls/:call-idRetrieve the properties and relationships of a call object. - DELETEDelete call
/communications/calls/:call-idDelete or hang up an active call. For group calls, this will only delete your call leg and the underlying group call will still continue. - PATCHUpdate call
/communications/calls/:call-id - POSTMute call
/communications/calls/:call-id/muteAllows the application to mute itself. This is a server mute, meaning that the server will drop all audio packets for this participant, even if the… - POSTAnswer call
/communications/calls/:call-id/answerEnable a bot to answer an incoming call. The incoming call request can be an invitation from a participant in a group call or a peer-to-peer call. If an… - POSTReject call
/communications/calls/:call-id/rejectEnable a bot to reject an incoming call. The incoming call request can be an invite from a participant in a group call or a peer-to-peer call. If an invite to… - POSTUnmute call
/communications/calls/:call-id/unmuteAllow the application to unmute itself. This is a server unmute, meaning that the server will start sending audio packets for this participant to other… - POSTRedirect call
/communications/calls/:call-id/redirectRedirect an incoming call that hasn't been answered or rejected yet. The terms 'redirecting' and 'forwarding' a call are used interchangeably. The bot is… - POSTTransfer call
/communications/calls/:call-id/transferTransfer an active peer-to-peer call or group call. A consultative transfer means that the transferor can inform the person they want to transfer the call to… - POSTKeep alive (call)
/communications/calls/:call-id/keepAliveMake a request to this API every 15 to 45 minutes to ensure that an ongoing call remains active. A call that doesn't receive this request within 45 minutes is… - GETList operations
/communications/calls/:call-id/operationsGet the status of an operation that adds the large gallery view to a call. - POSTCreate operation
/communications/calls/:call-id/operations - POSTPlay prompt (call)
/communications/calls/:call-id/playPromptPlay a prompt in the call. For more information about how to handle operations, see commsOperation - GETList participants
/communications/calls/:call-id/participantsRetrieve a list of participant objects in the call. - POSTCreate participant
/communications/calls/:call-id/participants - POSTSend dtmf tones (call)
/communications/calls/:call-id/sendDtmfTones - POSTRecord response (call)
/communications/calls/:call-id/recordResponseRecords a short audio response from the caller. A bot can utilize this to capture a voice response from a caller after they are prompted for a response. For… - POSTSubscribe to tone (call)
/communications/calls/:call-id/subscribeToToneSubscribe to DTMF (dual-tone multi-frequency signaling) which allows you to be notified when the user presses keys on a 'dialpad'. - GETList audio routing groups
/communications/calls/:call-id/audioRoutingGroupsRetrieve a list of audioRoutingGroup objects. - POSTCreate audio routing group
/communications/calls/:call-id/audioRoutingGroupsCreate a new audioRoutingGroup. - POSTAdd large gallery view (call)
/communications/calls/:call-id/addLargeGalleryViewAdd the large gallery view to a call. For details about how to identify a large gallery view participant in a roster so that you can retrieve the relevant… - POSTCancel media processing (call)
/communications/calls/:call-id/cancelMediaProcessingCancels processing for any in-progress media operations. Media operations refer to the IVR operations playPrompt and recordResponse, which are by default… - POSTUpdate recording status (call)
/communications/calls/:call-id/updateRecordingStatusUpdate the application's recording status associated with a call. This requires the use of the Teams policy-based recording solution. - GETList content sharing sessions
/communications/calls/:call-id/contentSharingSessionsRetrieve a list of contentSharingSession objects in a call. - POSTCreate content sharing session
/communications/calls/:call-id/contentSharingSessions - POSTChange screen sharing role (call)
/communications/calls/:call-id/changeScreenSharingRoleAllow applications to share screen content with the participants of a group call. - POSTInvite participant
/communications/calls/:call-id/participants/inviteDelete a specific participant in a call. In some situations, it is appropriate for an application to remove a participant from an active call. This action can… - GETGet participant
/communications/calls/:call-id/participants/:participant-idRetrieve the properties and relationships of a participant object. - DELETEDelete participant
/communications/calls/:call-id/participants/:participant-idDelete a specific participant in a call. In some situations, it is appropriate for an application to remove a participant from an active call. This action can… - PATCHUpdate participant
/communications/calls/:call-id/participants/:participant-id - GETGet operation
/communications/calls/:call-id/operations/:commsOperation-idGet the status of an operation that adds the large gallery view to a call. - DELETEDelete operation
/communications/calls/:call-id/operations/:commsOperation-id - PATCHUpdate operation
/communications/calls/:call-id/operations/:commsOperation-id - GETGet audio routing group
/communications/calls/:call-id/audioRoutingGroups/:audioRoutingGroup-idRetrieve the properties and relationships of an audioRoutingGroup object. - DELETEDelete audio routing group
/communications/calls/:call-id/audioRoutingGroups/:audioRoutingGroup-idDelete the specified audioRoutingGroup. - PATCHUpdate audio routing group
/communications/calls/:call-id/audioRoutingGroups/:audioRoutingGroup-idModify sources and receivers of an audioRoutingGroup. - GETGet content sharing session
/communications/calls/:call-id/contentSharingSessions/:contentSharingSession-idRetrieve the properties of a contentSharingSession object in a call. - DELETEDelete content sharing session
/communications/calls/:call-id/contentSharingSessions/:contentSharingSession-id - PATCHUpdate content sharing session
/communications/calls/:call-id/contentSharingSessions/:contentSharingSession-id - POSTMute participant
/communications/calls/:call-id/participants/:participant-id/muteMute a specific participant in the call. This is a server mute, meaning that the server will drop all audio packets for this participant, even if the… - POSTStop hold music (participant)
/communications/calls/:call-id/participants/:participant-id/stopHoldMusicReincorporate a participant previously put on hold to the call. - POSTStart hold music (participant)
/communications/calls/:call-id/participants/:participant-id/startHoldMusicPut a participant on hold and play music in the background.
Communications: presences
- GETList presences
/communications/presencesGet a user's presence information. - POSTCreate presence
/communications/presences - GETGet presence
/communications/presences/:presence-idGet a user's presence information. - DELETEDelete presence
/communications/presences/:presence-id - PATCHUpdate presence
/communications/presences/:presence-id - POSTSet presence (presence)
/communications/presences/:presence-id/setPresenceSet the state of a user's presence session as an application. For more information about presence sessions, states permutations, and timeouts, see Manage… - POSTClear location (presence)
/communications/presences/:presence-id/clearLocationClear the work location signals for a user, including both the manual and automatic layers for the current date. - POSTClear presence (presence)
/communications/presences/:presence-id/clearPresenceClear the application's presence session for a user. If it is the user's only presence session, the user's presence will change to Offline/Offline. For… - POSTSet status message (presence)
/communications/presences/:presence-id/setStatusMessageSet a presence status message for a user. An optional expiration date and time can be supplied. - POSTSet manual location (presence)
/communications/presences/:presence-id/setManualLocationSet the manual work location signal for a user. The explicit value chosen by a user or an authorized client overrides any automatically detected or scheduled… - POSTSet automatic location (presence)
/communications/presences/:presence-id/setAutomaticLocationUpdate the automatic work location for a user. The automatic layer participates in the standard precedence model: Use this operation from clients or services… - POSTClear automatic location (presence)
/communications/presences/:presence-id/clearAutomaticLocationClear the automatic work location signal for a user. After clearing, the user’s final aggregated work location is recomputed according to the precedence… - POSTSet user preferred presence (presence)
/communications/presences/:presence-id/setUserPreferredPresenceSet the preferred availability and activity status for a user. If the preferred presence of a user is set, the user's presence shows as the preferred status.… - POSTClear user preferred presence (presence)
/communications/presences/:presence-id/clearUserPreferredPresenceClear the preferred availability and activity status for a user.
Communications: adhoc calls
- GETList adhoc calls
/communications/adhocCalls - POSTCreate adhoc call
/communications/adhocCalls - GETGet all recordings (adhoc call)
/communications/adhocCalls/getAllRecordings(userId='@userId',startDateTime=@startDateTime,endDateTime=@endDateTime) - GETGet all transcripts (adhoc call)
/communications/adhocCalls/getAllTranscripts(userId='@userId',startDateTime=@startDateTime,endDateTime=@endDateTime) - GETGet adhoc call
/communications/adhocCalls/:adhocCall-id - DELETEDelete adhoc call
/communications/adhocCalls/:adhocCall-id - PATCHUpdate adhoc call
/communications/adhocCalls/:adhocCall-id - GETList recordings
/communications/adhocCalls/:adhocCall-id/recordingsThe recordings of a call. Read-only. - POSTCreate recording
/communications/adhocCalls/:adhocCall-id/recordings - GETList transcripts
/communications/adhocCalls/:adhocCall-id/transcriptsThe transcripts of a call. Read-only. - POSTCreate transcript
/communications/adhocCalls/:adhocCall-id/transcripts - GETTrack changes to recordings (delta)
/communications/adhocCalls/:adhocCall-id/recordings/delta() - GETTrack changes to transcripts (delta)
/communications/adhocCalls/:adhocCall-id/transcripts/delta() - GETGet recording
/communications/adhocCalls/:adhocCall-id/recordings/:callRecording-idThe recordings of a call. Read-only. - DELETEDelete recording
/communications/adhocCalls/:adhocCall-id/recordings/:callRecording-id - PATCHUpdate recording
/communications/adhocCalls/:adhocCall-id/recordings/:callRecording-id - GETGet transcript
/communications/adhocCalls/:adhocCall-id/transcripts/:callTranscript-idThe transcripts of a call. Read-only. - DELETEDelete transcript
/communications/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id - PATCHUpdate transcript
/communications/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id - GETDownload recording content
/communications/adhocCalls/:adhocCall-id/recordings/:callRecording-id/contentThe content of the recording. Read-only. - PUTUpload recording content
/communications/adhocCalls/:adhocCall-id/recordings/:callRecording-id/contentThe content of the recording. Read-only. - DELETEUpload recording content
/communications/adhocCalls/:adhocCall-id/recordings/:callRecording-id/contentThe content of the recording. Read-only. - GETDownload transcript content
/communications/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id/contentThe content of the transcript. Read-only. - PUTUpload transcript content
/communications/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id/contentThe content of the transcript. Read-only. - DELETEUpload transcript content
/communications/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id/contentThe content of the transcript. Read-only. - GETGet metadata content
/communications/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id/metadataContentThe time-aligned metadata of the utterances in the transcript. Read-only. - PUTReplace metadata content
/communications/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id/metadataContentThe time-aligned metadata of the utterances in the transcript. Read-only. - DELETEDelete metadata content
/communications/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id/metadataContentThe time-aligned metadata of the utterances in the transcript. Read-only.
Communications: call records
- GETList call records
/communications/callRecordsGet the list of callRecord objects and their properties. The results can be optionally filtered using the $filter query parameter on the startDateTime and… - POSTCreate call record
/communications/callRecords - GETGet call record
/communications/callRecords/:callRecord-idRetrieve the properties and relationships of a callRecord object. You can get the id of a callRecord in two ways: * Subscribe to change notifications to the… - DELETEDelete call record
/communications/callRecords/:callRecord-id - PATCHUpdate call record
/communications/callRecords/:callRecord-id - GETCall records.get pstn calls (call record)
/communications/callRecords/microsoft.graph.callRecords.getPstnCalls(fromDateTime=:fromDateTime,toDateTime=:toDateTime)Get a log of PSTN calls as a collection of pstnCallLogRow entries. - GETCall records.get direct routing calls (call record)
/communications/callRecords/microsoft.graph.callRecords.getDirectRoutingCalls(fromDateTime=:fromDateTime,toDateTime=:toDateTime)Get a log of direct routing calls as a collection of directRoutingLogRow entries. - GETList sessions
/communications/callRecords/:callRecord-id/sessionsRetrieve the list of sessions associated with a callRecord object. If the sessions list is truncated, a sessions@odata.nextLink value will be provided to… - POSTCreate session
/communications/callRecords/:callRecord-id/sessions - GETGet organizer_v2
/communications/callRecords/:callRecord-id/organizer_v2Identity of the organizer of the call. This relationship is expanded by default in callRecord methods. - DELETEDelete organizer_v2
/communications/callRecords/:callRecord-id/organizer_v2 - PATCHUpdate organizer_v2
/communications/callRecords/:callRecord-id/organizer_v2 - GETGet participants_v2
/communications/callRecords/:callRecord-id/participants_v2Get the list of participant objects associated with a callRecord. - POSTCreate participants_v2
/communications/callRecords/:callRecord-id/participants_v2 - GETGet session
/communications/callRecords/:callRecord-id/sessions/:session-idList of sessions involved in the call. Peer-to-peer calls typically only have one session, whereas group calls typically have at least one session per… - DELETEDelete session
/communications/callRecords/:callRecord-id/sessions/:session-id - PATCHUpdate session
/communications/callRecords/:callRecord-id/sessions/:session-id - GETGet participants_v2
/communications/callRecords/:callRecord-id/participants_v2/:participant-idList of distinct participants in the call. - DELETEDelete participants_v2
/communications/callRecords/:callRecord-id/participants_v2/:participant-id - PATCHUpdate participants_v2
/communications/callRecords/:callRecord-id/participants_v2/:participant-id - GETList segments
/communications/callRecords/:callRecord-id/sessions/:session-id/segmentsThe list of segments involved in the session. Read-only. Nullable. - POSTCreate segment
/communications/callRecords/:callRecord-id/sessions/:session-id/segments - GETGet segment
/communications/callRecords/:callRecord-id/sessions/:session-id/segments/:segment-idThe list of segments involved in the session. Read-only. Nullable. - DELETEDelete segment
/communications/callRecords/:callRecord-id/sessions/:session-id/segments/:segment-id - PATCHUpdate segment
/communications/callRecords/:callRecord-id/sessions/:session-id/segments/:segment-id
Communications: online meetings
- GETList online meetings
/communications/onlineMeetingsRetrieve the properties and relationships of an onlineMeeting object. For example, you can: Teams live event attendee report (deprecated) and Teams live event… - POSTCreate online meeting
/communications/onlineMeetings - POSTCreate or get (online meeting)
/communications/onlineMeetings/createOrGetCreate an onlineMeeting object with a custom specified external ID. If the external ID already exists, this API will return the onlineMeeting object with that… - GETGet all recordings (online meeting)
/communications/onlineMeetings/getAllRecordings(meetingOrganizerUserId='@meetingOrganizerUserId',startDateTime=@startDateTime,endDateTime=@endDateTime)Get all recordings from scheduled onlineMeeting instances for which the specified user is the organizer. This API currently doesn't support getting call… - GETGet all transcripts (online meeting)
/communications/onlineMeetings/getAllTranscripts(meetingOrganizerUserId='@meetingOrganizerUserId',startDateTime=@startDateTime,endDateTime=@endDateTime)Get all transcripts from scheduled onlineMeeting instances for which the specified user is the organizer. This API currently doesn't support getting call… - GETGet online meeting
/communications/onlineMeetings/:onlineMeeting-id - DELETEDelete online meeting
/communications/onlineMeetings/:onlineMeeting-id - PATCHUpdate online meeting
/communications/onlineMeetings/:onlineMeeting-id - GETList recordings
/communications/onlineMeetings/:onlineMeeting-id/recordingsThe recordings of an online meeting. Read-only. - POSTCreate recording
/communications/onlineMeetings/:onlineMeeting-id/recordings - GETList transcripts
/communications/onlineMeetings/:onlineMeeting-id/transcriptsThe transcripts of an online meeting. Read-only. - POSTCreate transcript
/communications/onlineMeetings/:onlineMeeting-id/transcripts - GETGet attendee report
/communications/onlineMeetings/:onlineMeeting-id/attendeeReportThe content stream of the attendee report of a Microsoft Teams live event. Read-only. - PUTReplace attendee report
/communications/onlineMeetings/:onlineMeeting-id/attendeeReportThe content stream of the attendee report of a Microsoft Teams live event. Read-only. - DELETEDelete attendee report
/communications/onlineMeetings/:onlineMeeting-id/attendeeReportThe content stream of the attendee report of a Microsoft Teams live event. Read-only. - GETList attendance reports
/communications/onlineMeetings/:onlineMeeting-id/attendanceReportsThe attendance reports of an online meeting. Read-only. - POSTCreate attendance report
/communications/onlineMeetings/:onlineMeeting-id/attendanceReports - POSTSend virtual appointment sms (online meeting)
/communications/onlineMeetings/:onlineMeeting-id/sendVirtualAppointmentSmsSend an SMS notification to external attendees when a Teams virtual appointment is confirmed, rescheduled, or canceled. This feature requires Teams premium.… - GETGet virtual appointment join web url (online meeting)
/communications/onlineMeetings/:onlineMeeting-id/getVirtualAppointmentJoinWebUrl()Get a join web URL for a Microsoft Virtual Appointment. This web URL includes enhanced business-to-customer experiences such as mobile browser join and… - POSTSend virtual appointment reminder sms (online meeting)
/communications/onlineMeetings/:onlineMeeting-id/sendVirtualAppointmentReminderSmsSend an SMS reminder to external attendees for a Teams virtual appointment. This feature requires Teams premium and attendees must have a valid United States… - GETTrack changes to recordings (delta)
/communications/onlineMeetings/:onlineMeeting-id/recordings/delta() - GETTrack changes to transcripts (delta)
/communications/onlineMeetings/:onlineMeeting-id/transcripts/delta() - GETGet recording
/communications/onlineMeetings/:onlineMeeting-id/recordings/:callRecording-idThe recordings of an online meeting. Read-only. - DELETEDelete recording
/communications/onlineMeetings/:onlineMeeting-id/recordings/:callRecording-id - PATCHUpdate recording
/communications/onlineMeetings/:onlineMeeting-id/recordings/:callRecording-id - GETGet transcript
/communications/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-idThe transcripts of an online meeting. Read-only. - DELETEDelete transcript
/communications/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id - PATCHUpdate transcript
/communications/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id - GETGet attendance report
/communications/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-idThe attendance reports of an online meeting. Read-only. - DELETEDelete attendance report
/communications/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id - PATCHUpdate attendance report
/communications/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id - GETDownload recording content
/communications/onlineMeetings/:onlineMeeting-id/recordings/:callRecording-id/contentThe content of the recording. Read-only. - PUTUpload recording content
/communications/onlineMeetings/:onlineMeeting-id/recordings/:callRecording-id/contentThe content of the recording. Read-only. - DELETEUpload recording content
/communications/onlineMeetings/:onlineMeeting-id/recordings/:callRecording-id/contentThe content of the recording. Read-only. - GETDownload transcript content
/communications/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id/contentThe content of the transcript. Read-only. - PUTUpload transcript content
/communications/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id/contentThe content of the transcript. Read-only. - DELETEUpload transcript content
/communications/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id/contentThe content of the transcript. Read-only. - GETGet metadata content
/communications/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id/metadataContentThe time-aligned metadata of the utterances in the transcript. Read-only. - PUTReplace metadata content
/communications/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id/metadataContentThe time-aligned metadata of the utterances in the transcript. Read-only. - DELETEDelete metadata content
/communications/onlineMeetings/:onlineMeeting-id/transcripts/:callTranscript-id/metadataContentThe time-aligned metadata of the utterances in the transcript. Read-only. - GETList attendance records
/communications/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id/attendanceRecordsList of attendance records of an attendance report. Read-only. - POSTCreate attendance record
/communications/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id/attendanceRecords - GETGet attendance record
/communications/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id/attendanceRecords/:attendanceRecord-idList of attendance records of an attendance report. Read-only. - DELETEDelete attendance record
/communications/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id/attendanceRecords/:attendanceRecord-id - PATCHUpdate attendance record
/communications/onlineMeetings/:onlineMeeting-id/attendanceReports/:meetingAttendanceReport-id/attendanceRecords/:attendanceRecord-id
Communications: online meeting conversations
- GETList online meeting conversations
/communications/onlineMeetingConversationsA collection of structured question-and-answer (Q&A) threads in Teams directly associated with online meetings. - POSTCreate online meeting conversation
/communications/onlineMeetingConversations - GETGet online meeting conversation
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-idA collection of structured question-and-answer (Q&A) threads in Teams directly associated with online meetings. - DELETEDelete online meeting conversation
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id - PATCHUpdate online meeting conversation
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id - GETGet starter
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starterThe first message in a Viva Engage conversation. - DELETEDelete starter
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter - PATCHUpdate starter
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter - GETList messages
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messagesThe messages in a Viva Engage conversation. - POSTCreate message
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages - GETGet online meeting
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/onlineMeetingThe online meeting associated with the conversation. - GETList replies
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/repliesA collection of messages that are replies to this message and form a threaded discussion. - POSTCreate reply
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/replies - GETReply to (starter)
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/replyToThe parent message to which this message is a reply, if it is part of a reply chain. - GETList reactions
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/reactionsA collection of reactions (such as like and smile) that users have applied to this message. - POSTCreate reaction
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/reactions - GETGet conversation
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/conversationThe Viva Engage conversation to which this message belongs. This relationship establishes the thread context for the message. - GETGet attendee report
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/onlineMeeting/attendeeReportThe content stream of the attendee report of a Microsoft Teams live event. Read-only. - PUTReplace attendee report
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/onlineMeeting/attendeeReportThe content stream of the attendee report of a Microsoft Teams live event. Read-only. - DELETEDelete attendee report
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/onlineMeeting/attendeeReportThe content stream of the attendee report of a Microsoft Teams live event. Read-only. - GETGet message
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-idThe messages in a Viva Engage conversation. - DELETEDelete message
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id - PATCHUpdate message
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id - GETGet reply
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/replies/:engagementConversationMessage-idA collection of messages that are replies to this message and form a threaded discussion. - DELETEDelete reply
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/replies/:engagementConversationMessage-id - PATCHUpdate reply
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/replies/:engagementConversationMessage-id - GETList replies
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id/repliesA collection of messages that are replies to this message and form a threaded discussion. - POSTCreate reply
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id/replies - GETReply to (message)
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id/replyToThe parent message to which this message is a reply, if it is part of a reply chain. - GETList reactions
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id/reactionsGet a list of the engagementConversationMessageReaction objects and their properties for an engagementConversationMessage in an online meeting. - POSTCreate reaction
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id/reactions - GETGet conversation
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id/conversationThe Viva Engage conversation to which this message belongs. This relationship establishes the thread context for the message. - GETGet reaction
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/reactions/:engagementConversationMessageReaction-idA collection of reactions (such as like and smile) that users have applied to this message. - DELETEDelete reaction
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/reactions/:engagementConversationMessageReaction-id - PATCHUpdate reaction
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/reactions/:engagementConversationMessageReaction-id - GETReply to (reply)
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/replies/:engagementConversationMessage-id/replyToThe parent message to which this message is a reply, if it is part of a reply chain. - GETList reactions
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/replies/:engagementConversationMessage-id/reactionsA collection of reactions (such as like and smile) that users have applied to this message. - POSTCreate reaction
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/replies/:engagementConversationMessage-id/reactions - GETGet conversation
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/starter/replies/:engagementConversationMessage-id/conversationThe Viva Engage conversation to which this message belongs. This relationship establishes the thread context for the message. - GETGet reply
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id/replies/:engagementConversationMessage-id1A collection of messages that are replies to this message and form a threaded discussion. - DELETEDelete reply
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id/replies/:engagementConversationMessage-id1 - PATCHUpdate reply
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id/replies/:engagementConversationMessage-id1 - GETGet reaction
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id/reactions/:engagementConversationMessageReaction-idA collection of reactions (such as like and smile) that users have applied to this message. - DELETEDelete reaction
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id/reactions/:engagementConversationMessageReaction-id - PATCHUpdate reaction
/communications/onlineMeetingConversations/:onlineMeetingEngagementConversation-id/messages/:engagementConversationMessage-id/reactions/:engagementConversationMessageReaction-id
Adhoc calls: recordings
- GETList recordings
/me/adhocCalls/:adhocCall-id/recordingsThe recordings of a call. Read-only. - POSTCreate recording
/me/adhocCalls/:adhocCall-id/recordings - GETTrack changes to recordings (delta)
/me/adhocCalls/:adhocCall-id/recordings/delta() - GETGet recording
/me/adhocCalls/:adhocCall-id/recordings/:callRecording-idThe recordings of a call. Read-only. - DELETEDelete recording
/me/adhocCalls/:adhocCall-id/recordings/:callRecording-id - PATCHUpdate recording
/me/adhocCalls/:adhocCall-id/recordings/:callRecording-id - GETDownload recording content
/me/adhocCalls/:adhocCall-id/recordings/:callRecording-id/contentThe content of the recording. Read-only. - PUTUpload recording content
/me/adhocCalls/:adhocCall-id/recordings/:callRecording-id/contentThe content of the recording. Read-only. - DELETEUpload recording content
/me/adhocCalls/:adhocCall-id/recordings/:callRecording-id/contentThe content of the recording. Read-only.
Adhoc calls: transcripts
- GETList transcripts
/me/adhocCalls/:adhocCall-id/transcriptsThe transcripts of a call. Read-only. - POSTCreate transcript
/me/adhocCalls/:adhocCall-id/transcripts - GETTrack changes to transcripts (delta)
/me/adhocCalls/:adhocCall-id/transcripts/delta() - GETGet transcript
/me/adhocCalls/:adhocCall-id/transcripts/:callTranscript-idThe transcripts of a call. Read-only. - DELETEDelete transcript
/me/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id - PATCHUpdate transcript
/me/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id - GETDownload transcript content
/me/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id/contentThe content of the transcript. Read-only. - PUTUpload transcript content
/me/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id/contentThe content of the transcript. Read-only. - DELETEUpload transcript content
/me/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id/contentThe content of the transcript. Read-only. - GETGet metadata content
/me/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id/metadataContentThe time-aligned metadata of the utterances in the transcript. Read-only. - PUTReplace metadata content
/me/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id/metadataContentThe time-aligned metadata of the utterances in the transcript. Read-only. - DELETEDelete metadata content
/me/adhocCalls/:adhocCall-id/transcripts/:callTranscript-id/metadataContentThe time-aligned metadata of the utterances in the transcript. Read-only.
API details
- Base URL
https://graph.microsoft.com/v1.0- Authentication
- OAuth 2.0 (authorization code, client credentials flows)
- Operations
- 291 operations on 157 pathsGET 112POST 78DELETE 50PATCH 36PUT 15
- Main resources
- Communications: calls 45Communications: online meeting conversations 45Communications: online meetings 45Communications: adhoc calls 28Communications: call records 25Communications: presences 14Adhoc calls: transcripts 12Online meetings: transcripts 12Presence 12Online meetings 11
- Description format
- OpenAPI 3.0.4, API version
v1.0 - Links
- Documentation · OpenAPI document
How to test the Microsoft Graph: Online meetings, calls and presence in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Microsoft Graph: Online meetings, calls and presence collection, without the publisher's secrets.
- Add your credentialsThis API uses OAuth 2.0 (authorization code, client credentials flows). Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “List online meetings” (GET /me/onlineMeetings), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Microsoft Graph: Online meetings, calls and presence?
Create Teams online meetings, read attendance reports, recordings and transcripts, read call records, place and manage calls from a bot, and read or set… It is listed under Communication and has 291 endpoints.
Who publishes the Microsoft Graph: Online meetings, calls and presence?
It is listed from Microsoft's public API description (an OpenAPI document), not published by Microsoft on Swastik Codes. Anyone who controls microsoft.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Microsoft Graph: Online meetings, calls and presence?
Requests go to https://graph.microsoft.com/v1.0. Endpoint paths are added to this base URL.
How do I authenticate with the Microsoft Graph: Online meetings, calls and presence?
With OAuth 2.0 (authorization code, client credentials flows).
How many endpoints does the Microsoft Graph: Online meetings, calls and presence have?
291 operations on 157 paths (112 GET, 78 POST, 50 DELETE, 36 PATCH, 15 PUT). The largest groups are Communications: calls, Communications: online meeting conversations, Communications: online meetings, Communications: adhoc calls.
Is forking the Microsoft Graph: Online meetings, calls and presence free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.