Microsoft: Update the navigation property calendars in users — users Calendar Group calendar Groups Update Calendars

Microsoft usersCalendarGroup.calendarGroupsUpdateCalendars: arguments, response, policy and SDK examples.

← Users calendar group operations · Get started

Operation microsoft.users_calendargroups_updatecalendars

Provider route: PATCH /users/{user-id}/calendarGroups/{calendarGroup-id}/calendars/{calendar-id}. Alter supplies the connection’s credentials and routing.

Call through Alter

Install @alter-ai/sdk @alter-ai/microsoft with npm, or alter-sdk-microsoft with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { MicrosoftIntegration } from "@alter-ai/microsoft";

async function execute(input: Parameters<MicrosoftIntegration["usersCalendarGroup"]["calendarGroupsUpdateCalendars"]>[0]) {
  const app = new App({ apiKey: process.env.ALTER_API_KEY! });
  try {
    const provider = new MicrosoftIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
    const call = await provider.usersCalendarGroup.calendarGroupsUpdateCalendars(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from alter_sdk_microsoft import MicrosoftIntegration

async def execute(arguments):
    async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
        provider = MicrosoftIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
        call = await provider.users_calendar_group.calendar_groups_update_calendars(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
`$`	object	Root	Additional keys: not allowed
`path`	object	Required within parent	Additional keys: not allowed
`path.user-id`	string	Required within parent
`path.calendarGroup-id`	string	Required within parent
`path.calendar-id`	string	Required within parent
`body`	Model	Required within parent	Expand Create Calendar — request body — body

Referenced models: Create Calendar — request body — body

Response

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

Field	Type	Presence	Description and constraints
`$`	Model	Root	Expand Get calendar — response body

Referenced models: Get calendar — response body

Schemas

38 more schemas are linked from the tables above, on the schema pages.

Get calendar — response body

Field	Type	Presence	Description and constraints
`$`	JSON	Root
`$ (allOf 1)`	Model	All variants apply	Expand Get rule — response body — @odata type, id
`$ (allOf 2)`	object	All variants apply
`$ (allOf 2).@odata.type`	string	Optional
`$ (allOf 2).allowedOnlineMeetingProviders`	array	Optional	Represent the online meeting service providers that can be used to create online meetings in this calendar. The possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
`$ (allOf 2).allowedOnlineMeetingProviders[]`	JSON	Each item
`$ (allOf 2).allowedOnlineMeetingProviders[] (anyOf 1)`	string	Alternative	Known values: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness
`$ (allOf 2).allowedOnlineMeetingProviders[] (anyOf 2)`	JSON	Alternative
`$ (allOf 2).allowedOnlineMeetingProviders[] (anyOf 2) (anyOf 1)`	object	Alternative
`$ (allOf 2).allowedOnlineMeetingProviders[] (anyOf 2) (anyOf 2)`	null	Alternative
`$ (allOf 2).calendarPermissions`	array	Optional	The permissions of the users with whom the calendar is shared.
`$ (allOf 2).calendarPermissions[]`	Model	Each item	Expand Get calendar Permission — response body
`$ (allOf 2).calendarView`	array	Optional	The calendar view for the calendar. Navigation property. Read-only.
`$ (allOf 2).calendarView[]`	Model	Each item	Expand Get event — response body
`$ (allOf 2).canEdit`	JSON	Optional
`$ (allOf 2).canEdit (anyOf 1)`	boolean	Alternative	true if the user can write to the calendar, false otherwise. This property is true for the user who created the calendar. This property is also true for a user who shared a calendar and granted write access.
`$ (allOf 2).canEdit (anyOf 2)`	null	Alternative
`$ (allOf 2).canShare`	JSON	Optional
`$ (allOf 2).canShare (anyOf 1)`	boolean	Alternative	true if the user has permission to share the calendar, false otherwise. Only the user who created the calendar can share it.
`$ (allOf 2).canShare (anyOf 2)`	null	Alternative
`$ (allOf 2).canViewPrivateItems`	JSON	Optional
`$ (allOf 2).canViewPrivateItems (anyOf 1)`	boolean	Alternative	If true, the user can read calendar items that have been marked private, false otherwise.
`$ (allOf 2).canViewPrivateItems (anyOf 2)`	null	Alternative
`$ (allOf 2).changeKey`	JSON	Optional
`$ (allOf 2).changeKey (anyOf 1)`	string	Alternative	Identifies the version of the calendar object. Every time the calendar is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.
`$ (allOf 2).changeKey (anyOf 2)`	null	Alternative
`$ (allOf 2).color`	JSON	Optional	Specifies the color theme to distinguish the calendar from other calendars in a UI. The property values are: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed, maxColor.
`$ (allOf 2).color (anyOf 1)`	string	Alternative	Known values: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed, maxColor
`$ (allOf 2).color (anyOf 2)`	JSON	Alternative
`$ (allOf 2).color (anyOf 2) (anyOf 1)`	object	Alternative
`$ (allOf 2).color (anyOf 2) (anyOf 2)`	null	Alternative
`$ (allOf 2).defaultOnlineMeetingProvider`	JSON	Optional	The default online meeting provider for meetings sent from this calendar. The possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
`$ (allOf 2).defaultOnlineMeetingProvider (anyOf 1)`	string	Alternative	Known values: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness
`$ (allOf 2).defaultOnlineMeetingProvider (anyOf 2)`	JSON	Alternative
`$ (allOf 2).defaultOnlineMeetingProvider (anyOf 2) (anyOf 1)`	object	Alternative
`$ (allOf 2).defaultOnlineMeetingProvider (anyOf 2) (anyOf 2)`	null	Alternative
`$ (allOf 2).events`	array	Optional	The events in the calendar. Navigation property. Read-only.
`$ (allOf 2).events[]`	Model	Each item	Expand Get event — response body
`$ (allOf 2).hexColor`	JSON	Optional
`$ (allOf 2).hexColor (anyOf 1)`	string	Alternative	The calendar color, expressed in a hex color code of three hexadecimal values, each ranging from 00 to FF and representing the red, green, or blue components of the color in the RGB color space. If the user has never explicitly set a color for the calendar, this property is empty. Read-only.
`$ (allOf 2).hexColor (anyOf 2)`	null	Alternative
`$ (allOf 2).isDefaultCalendar`	JSON	Optional
`$ (allOf 2).isDefaultCalendar (anyOf 1)`	boolean	Alternative	true if this is the default calendar where new events are created by default, false otherwise.
`$ (allOf 2).isDefaultCalendar (anyOf 2)`	null	Alternative
`$ (allOf 2).isRemovable`	JSON	Optional
`$ (allOf 2).isRemovable (anyOf 1)`	boolean	Alternative	Indicates whether this user calendar can be deleted from the user mailbox.
`$ (allOf 2).isRemovable (anyOf 2)`	null	Alternative
`$ (allOf 2).isTallyingResponses`	JSON	Optional
`$ (allOf 2).isTallyingResponses (anyOf 1)`	boolean	Alternative	Indicates whether this user calendar supports tracking of meeting responses. Only meeting invites sent from users' primary calendars support tracking of meeting responses.
`$ (allOf 2).isTallyingResponses (anyOf 2)`	null	Alternative
`$ (allOf 2).multiValueExtendedProperties`	array	Optional	The collection of multi-value extended properties defined for the calendar. Read-only. Nullable.
`$ (allOf 2).multiValueExtendedProperties[]`	Model	Each item	Expand Get mail Folder — response body — @odata type, child Folder Count, child Folders, display Name, is Hidden, message Rules, messages, multi Value Extended Properties, parent Folder Id, single Value Extended Properties, total Item Count, unread Item Count multi Value Extended Properties item
`$ (allOf 2).name`	JSON	Optional
`$ (allOf 2).name (anyOf 1)`	string	Alternative	The calendar name.
`$ (allOf 2).name (anyOf 2)`	null	Alternative
`$ (allOf 2).owner`	JSON	Optional	If set, this represents the user who created or added the calendar. For a calendar that the user created or added, the owner property is set to the user. For a calendar shared with the user, the owner property is set to the person who shared that calendar with the user.
`$ (allOf 2).owner (anyOf 1)`	Model	Alternative	Expand Get calendar Permission — response body — @odata type, allowed Roles, email Address, is Inside Organization, is Removable, role email Address @odata type, address, name
`$ (allOf 2).owner (anyOf 2)`	JSON	Alternative
`$ (allOf 2).owner (anyOf 2) (anyOf 1)`	object	Alternative
`$ (allOf 2).owner (anyOf 2) (anyOf 2)`	null	Alternative
`$ (allOf 2).singleValueExtendedProperties`	array	Optional	The collection of single-value extended properties defined for the calendar. Read-only. Nullable.
`$ (allOf 2).singleValueExtendedProperties[]`	Model	Each item	Expand Get mail Folder — response body — @odata type, child Folder Count, child Folders, display Name, is Hidden, message Rules, messages, multi Value Extended Properties, parent Folder Id, single Value Extended Properties, total Item Count, unread Item Count single Value Extended Properties item

Referenced models: Get calendar Permission — response body, Get calendar Permission — response body — @odata type, allowed Roles, email Address, is Inside Organization, is Removable, role email Address @odata type, address, name, Get rule — response body — @odata type, id, Get event — response body, Get mail Folder — response body — @odata type, child Folder Count, child Folders, display Name, is Hidden, message Rules, messages, multi Value Extended Properties, parent Folder Id, single Value Extended Properties, total Item Count, unread Item Count multi Value Extended Properties item, Get mail Folder — response body — @odata type, child Folder Count, child Folders, display Name, is Hidden, message Rules, messages, multi Value Extended Properties, parent Folder Id, single Value Extended Properties, total Item Count, unread Item Count single Value Extended Properties item

Get calendar Permission — response body — @odata type, allowed Roles, email Address, is Inside Organization, is Removable, role email Address @odata type, address, name

Field	Type	Presence	Description and constraints
`$`	object	Root
`@odata.type`	string	Optional
`address`	JSON	Optional
`address (anyOf 1)`	string	Alternative	The email address of the person or entity.
`address (anyOf 2)`	null	Alternative
`name`	JSON	Optional
`name (anyOf 1)`	string	Alternative	The display name of the person or entity.
`name (anyOf 2)`	null	Alternative

Get mail Folder — response body — @odata type, child Folder Count, child Folders, display Name, is Hidden, message Rules, messages, multi Value Extended Properties, parent Folder Id, single Value Extended Properties, total Item Count, unread Item Count multi Value Extended Properties item

Field	Type	Presence	Description and constraints
`$`	JSON	Root
`$ (allOf 1)`	Model	All variants apply	Expand Get rule — response body — @odata type, id
`$ (allOf 2)`	object	All variants apply
`$ (allOf 2).@odata.type`	string	Optional
`$ (allOf 2).value`	array	Optional	A collection of property values.
`$ (allOf 2).value[]`	JSON	Each item
`$ (allOf 2).value[] (anyOf 1)`	string	Alternative
`$ (allOf 2).value[] (anyOf 2)`	null	Alternative

Referenced models: Get rule — response body — @odata type, id

Policy, approvals and errors

SDK function policy ID: microsoft.users_calendargroups_updatecalendars. Catalog operation: users_calendargroups_updatecalendars. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Official provider source

Report an issue with this page