Skip to main content
PATCH
Edit or reschedule an Outlook calendar event

Authorizations

x-api-key
string
header
required

Organization API key passed as the x-api-key header. The raw key is the header value; do not prefix it with Bearer.

Path Parameters

eventId
string
required
Required string length: 1 - 512

Body

application/json
confirmNotifications
boolean
required

The user explicitly authorized this update and potential attendee email notifications from Microsoft Graph.

subject
string
Required string length: 1 - 255
body
string
Maximum string length: 20000
bodyContentType
enum<string>

How Outlook stores body: text (default) or html. Only allowed together with body.

Available options:
text,
html
start
string<date-time>

New UTC start, with Z suffix. Rescheduling requires both start and end.

Maximum string length: 40
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
end
string<date-time>

New UTC end, with Z suffix.

Maximum string length: 40
Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
location
string
Maximum string length: 255
isOnlineMeeting
boolean

true adds a Teams meeting and join link to this event. Microsoft cannot remove one again through this field.

onlineMeetingProvider
enum<string>

Online meeting service; teamsForBusiness when omitted. Only with isOnlineMeeting: true.

Available options:
teamsForBusiness,
skypeForBusiness,
skypeForConsumer

Response

Microsoft Graph mutation receipt returned.

ok
boolean
required
event
object
required
warning
string

Present when a Teams meeting was asked for but Microsoft returned no join link. The event exists; do not create it again.