@@ -2472,6 +2472,7 @@ export interface Invitation extends Entity {
24722472 invitedUser?: NullableOption<User>;
24732473}
24742474export interface DirectoryObject extends Entity {
2475+ // Date and time when this object was deleted. Always null when the object hasn't been deleted.
24752476 deletedDateTime?: NullableOption<string>;
24762477}
24772478export interface User extends DirectoryObject {
@@ -2940,7 +2941,7 @@ export interface AppRoleAssignment extends DirectoryObject {
29402941 */
29412942 appRoleId?: string;
29422943 /**
2943- * The time when the app role assignment was created.The Timestamp type represents date and time information using ISO
2944+ * The time when the app role assignment was created. The Timestamp type represents date and time information using ISO
29442945 * 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.
29452946 */
29462947 createdDateTime?: NullableOption<string>;
@@ -2949,9 +2950,9 @@ export interface AppRoleAssignment extends DirectoryObject {
29492950 * $filter (eq and startswith).
29502951 */
29512952 principalDisplayName?: NullableOption<string>;
2952- // The unique identifier (id) for the user, group or service principal being granted the app role. Required on create.
2953+ // The unique identifier (id) for the user, group, or service principal being granted the app role. Required on create.
29532954 principalId?: NullableOption<string>;
2954- // The type of the assigned principal. This can either be User, Group or ServicePrincipal. Read-only.
2955+ // The type of the assigned principal. This can either be User, Group, or ServicePrincipal. Read-only.
29552956 principalType?: NullableOption<string>;
29562957 // The display name of the resource app's service principal to which the assignment is made.
29572958 resourceDisplayName?: NullableOption<string>;
@@ -3912,6 +3913,7 @@ export interface Chat extends Entity {
39123913 members?: NullableOption<ConversationMember[]>;
39133914 // A collection of all the messages in the chat. Nullable.
39143915 messages?: NullableOption<ChatMessage[]>;
3916+ // A collection of all the tabs in the chat. Nullable.
39153917 tabs?: NullableOption<TeamsTab[]>;
39163918}
39173919export interface Team extends Entity {
@@ -4240,6 +4242,11 @@ export interface ServicePrincipal extends DirectoryObject {
42404242 * authorization codes and access tokens are sent to for the associated application. Not nullable.
42414243 */
42424244 replyUrls?: string[];
4245+ /**
4246+ * The resource-specific application permissions exposed by this application. Currently, resource-specific permissions are
4247+ * only supported for Teams apps accessing to specific chats and teams using Microsoft Graph. Read-only.
4248+ */
4249+ resourceSpecificApplicationPermissions?: ResourceSpecificPermission[];
42434250 // The collection for settings related to saml single sign-on.
42444251 samlSingleSignOnSettings?: NullableOption<SamlSingleSignOnSettings>;
42454252 /**
@@ -4696,7 +4703,11 @@ export interface BookingAppointment extends Entity {
46964703 isLocationOnline?: boolean;
46974704 // The URL of the online meeting for the appointment.
46984705 joinWebUrl?: NullableOption<string>;
4699- // The maximum number of customers allowed in an appointment.
4706+ /**
4707+ * The maximum number of customers allowed in an appointment. If maximumAttendeesCount of the service is greater than 1,
4708+ * pass valid customer IDs while creating or updating an appointment. To create a customer, use the Create bookingCustomer
4709+ * operation.
4710+ */
47004711 maximumAttendeesCount?: number;
47014712 /**
47024713 * If true indicates that the bookingCustomer for this appointment does not wish to receive a confirmation for this
@@ -4831,7 +4842,11 @@ export interface BookingService extends Entity {
48314842 isHiddenFromCustomers?: boolean;
48324843 // True indicates that the appointments for the service will be held online. Default value is false.
48334844 isLocationOnline?: boolean;
4834- // The maximum number of customers allowed in a service.
4845+ /**
4846+ * The maximum number of customers allowed in a service. If maximumAttendeesCount of the service is greater than 1, pass
4847+ * valid customer IDs while creating or updating an appointment. To create a customer, use the Create bookingCustomer
4848+ * operation.
4849+ */
48354850 maximumAttendeesCount?: number;
48364851 // Additional information about this service.
48374852 notes?: NullableOption<string>;
@@ -5243,7 +5258,7 @@ export interface Group extends DirectoryObject {
52435258 owners?: NullableOption<DirectoryObject[]>;
52445259 // The permission that has been granted for a group to a specific application. Supports $expand.
52455260 permissionGrants?: NullableOption<ResourceSpecificPermissionGrant[]>;
5246- // Read-only . Nullable.
5261+ // Settings that can govern this group's behavior, like whether members can invite guest users to the group . Nullable.
52475262 settings?: NullableOption<GroupSetting[]>;
52485263 transitiveMemberOf?: NullableOption<DirectoryObject[]>;
52495264 transitiveMembers?: NullableOption<DirectoryObject[]>;
@@ -5375,9 +5390,15 @@ export interface ResourceSpecificPermissionGrant extends DirectoryObject {
53755390export interface GroupSetting extends Entity {
53765391 // Display name of this group of settings, which comes from the associated template.
53775392 displayName?: NullableOption<string>;
5378- // Unique identifier for the template used to create this group of settings. Read-only.
5393+ /**
5394+ * Unique identifier for the tenant-level groupSettingTemplates object that's been customized for this group-level
5395+ * settings object. Read-only.
5396+ */
53795397 templateId?: NullableOption<string>;
5380- // Collection of name value pairs. Must contain and set all the settings defined in the template.
5398+ /**
5399+ * Collection of name-value pairs corresponding to the name and defaultValue properties in the referenced
5400+ * groupSettingTemplates object.
5401+ */
53815402 values?: SettingValue[];
53825403}
53835404export interface Conversation extends Entity {
@@ -6113,7 +6134,10 @@ export interface DomainDnsUnavailableRecord extends DomainDnsRecord {
61136134export interface GroupSettingTemplate extends DirectoryObject {
61146135 // Description of the template.
61156136 description?: NullableOption<string>;
6116- // Display name of the template.
6137+ /**
6138+ * Display name of the template. The template named Group.Unified can be used to configure tenant-wide Microsoft 365 group
6139+ * settings, while the template named Group.Unified.Guest can be used to configure group-specific settings.
6140+ */
61176141 displayName?: NullableOption<string>;
61186142 /**
61196143 * Collection of settingTemplateValues that list the set of available settings, defaults and types that make up this
@@ -7029,7 +7053,7 @@ export interface ListItem extends BaseItem {
70297053 versions?: NullableOption<ListItemVersion[]>;
70307054}
70317055export interface Subscription extends Entity {
7032- // Identifier of the application used to create the subscription. Read-only.
7056+ // Optional. Identifier of the application used to create the subscription. Read-only.
70337057 applicationId?: NullableOption<string>;
70347058 /**
70357059 * Required. Indicates the type of change in the subscribed resource that will raise a change notification. The supported
@@ -7046,13 +7070,14 @@ export interface Subscription extends Entity {
70467070 */
70477071 clientState?: NullableOption<string>;
70487072 /**
7049- * Identifier of the user or service principal that created the subscription. If the app used delegated permissions to
7050- * create the subscription, this field contains the id of the signed-in user the app called on behalf of. If the app used
7051- * application permissions, this field contains the id of the service principal corresponding to the app. Read-only.
7073+ * Optional. Identifier of the user or service principal that created the subscription. If the app used delegated
7074+ * permissions to create the subscription, this field contains the id of the signed-in user the app called on behalf of.
7075+ * If the app used application permissions, this field contains the id of the service principal corresponding to the app.
7076+ * Read-only.
70527077 */
70537078 creatorId?: NullableOption<string>;
70547079 /**
7055- * A base64-encoded representation of a certificate with a public key used to encrypt resource data in change
7080+ * Optional. A base64-encoded representation of a certificate with a public key used to encrypt resource data in change
70567081 * notifications. Optional but required when includeResourceData is true.
70577082 */
70587083 encryptionCertificate?: NullableOption<string>;
@@ -7067,7 +7092,7 @@ export interface Subscription extends Entity {
70677092 // Optional. When set to true, change notifications include resource data (such as content of a chat message).
70687093 includeResourceData?: NullableOption<boolean>;
70697094 /**
7070- * Specifies the latest version of Transport Layer Security (TLS) that the notification endpoint, specified by
7095+ * Optional. Specifies the latest version of Transport Layer Security (TLS) that the notification endpoint, specified by
70717096 * notificationUrl, supports. The possible values are: v1_0, v1_1, v1_2, v1_3. For subscribers whose notification endpoint
70727097 * supports a version lower than the currently recommended version (TLS 1.2), specifying this property by a set timeline
70737098 * allows them to temporarily use their deprecated version of TLS before completing their upgrade to TLS 1.2. For these
@@ -7082,18 +7107,22 @@ export interface Subscription extends Entity {
70827107 */
70837108 lifecycleNotificationUrl?: NullableOption<string>;
70847109 /**
7085- * OData query options for specifying value for the targeting resource. Clients receive notifications when resource
7086- * reaches the state matching the query options provided here. With this new property in the subscription creation payload
7087- * along with all existing properties, Webhooks will deliver notifications whenever a resource reaches the desired state
7088- * mentioned in the notificationQueryOptions property. For example, when the print job is completed or when a print job
7089- * resource isFetchable property value becomes true etc.
7110+ * Optional. OData query options for specifying value for the targeting resource. Clients receive notifications when
7111+ * resource reaches the state matching the query options provided here. With this new property in the subscription
7112+ * creation payload along with all existing properties, Webhooks will deliver notifications whenever a resource reaches
7113+ * the desired state mentioned in the notificationQueryOptions property. For example, when the print job is completed or
7114+ * when a print job resource isFetchable property value becomes true etc.
70907115 */
70917116 notificationQueryOptions?: NullableOption<string>;
70927117 /**
70937118 * Required. The URL of the endpoint that will receive the change notifications. This URL must make use of the HTTPS
70947119 * protocol.
70957120 */
70967121 notificationUrl?: string;
7122+ /**
7123+ * Optional. The app ID that the subscription service can use to generate the validation token. This allows the client to
7124+ * validate the authenticity of the notification received.
7125+ */
70977126 notificationUrlAppId?: NullableOption<string>;
70987127 /**
70997128 * Required. Specifies the resource that will be monitored for changes. Do not include the base URL
@@ -8667,14 +8696,21 @@ export interface IdentityProtectionRoot {
86678696 riskyUsers?: NullableOption<RiskyUser[]>;
86688697}
86698698export interface RiskDetection extends Entity {
8670- // Indicates the activity type the detected risk is linked to. . Possible values are: signin, user, unknownFutureValue.
8699+ // Indicates the activity type the detected risk is linked to. Possible values are: signin, user, unknownFutureValue.
86718700 activity?: NullableOption<ActivityType>;
86728701 /**
86738702 * Date and time that the risky activity occurred. The DateTimeOffset type represents date and time information using ISO
86748703 * 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is look like this: 2014-01-01T00:00:00Z
86758704 */
86768705 activityDateTime?: NullableOption<string>;
8677- // Additional information associated with the risk detection in JSON format.
8706+ /**
8707+ * Additional information associated with the risk detection in JSON format. For example,
8708+ * '[{/'Key/':/'userAgent/',/'Value/':/'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko)
8709+ * Chrome/68.0.3440.106 Safari/537.36/'}]'. Possible keys in the additionalInfo JSON string are: userAgent, alertUrl,
8710+ * relatedEventTimeInUtc, relatedUserAgent, deviceInformation, relatedLocation, requestId, correlationId,
8711+ * lastActivityTimeInUtc, malwareName, clientLocation, clientIp, riskReasons. For more information about riskReasons and
8712+ * possible values, see riskReasons values.
8713+ */
86788714 additionalInfo?: NullableOption<string>;
86798715 /**
86808716 * Correlation ID of the sign-in associated with the risk detection. This property is null if the risk detection is not
@@ -8683,7 +8719,7 @@ export interface RiskDetection extends Entity {
86838719 correlationId?: NullableOption<string>;
86848720 /**
86858721 * Date and time that the risk was detected. The DateTimeOffset type represents date and time information using ISO 8601
8686- * format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is look like this: 2014-01-01T00:00:00Z
8722+ * format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 looks like this: 2014-01-01T00:00:00Z
86878723 */
86888724 detectedDateTime?: NullableOption<string>;
86898725 /**
@@ -8716,10 +8752,10 @@ export interface RiskDetection extends Entity {
87168752 /**
87178753 * The type of risk event detected. The possible values are unlikelyTravel, anonymizedIPAddress, maliciousIPAddress,
87188754 * unfamiliarFeatures, malwareInfectedIPAddress, suspiciousIPAddress, leakedCredentials, investigationsThreatIntelligence,
8719- * generic,adminConfirmedUserCompromised, mcasImpossibleTravel, mcasSuspiciousInboxManipulationRules ,
8720- * investigationsThreatIntelligenceSigninLinked, maliciousIPAddressValidCredentialsBlockedIP, and unknownFutureValue. If
8721- * the risk detection is a premium detection, will show generic. For more information about each value, see riskEventType
8722- * values.
8755+ * generic,adminConfirmedUserCompromised, passwordSpray, impossibleTravel, newCountry, anomalousToken ,
8756+ * tokenIssuerAnomaly,suspiciousBrowser, riskyIPAddress, mcasSuspiciousInboxManipulationRules, suspiciousInboxForwarding,
8757+ * and unknownFutureValue. If the risk detection is a premium detection, will show generic. For more information about
8758+ * each value, see riskEventType values.
87238759 */
87248760 riskEventType?: NullableOption<string>;
87258761 // Level of the detected risk. Possible values are: low, medium, high, hidden, none, unknownFutureValue.
@@ -13034,7 +13070,7 @@ export interface PlannerProgressTaskBoardTaskFormat extends Entity {
1303413070export interface PlannerTaskDetails extends Entity {
1303513071 // The collection of checklist items on the task.
1303613072 checklist?: NullableOption<PlannerChecklistItems>;
13037- // Description of the task
13073+ // Description of the task.
1303813074 description?: NullableOption<string>;
1303913075 /**
1304013076 * This sets the type of preview that shows up on the task. The possible values are: automatic, noPreview, checklist,
@@ -13774,7 +13810,12 @@ export interface WindowsHelloForBusinessAuthenticationMethod extends Authenticat
1377413810 displayName?: NullableOption<string>;
1377513811 // Key strength of this Windows Hello for Business key. Possible values are: normal, weak, unknown.
1377613812 keyStrength?: NullableOption<AuthenticationMethodKeyStrength>;
13777- // The registered device on which this Windows Hello for Business key resides.
13813+ /**
13814+ * The registered device on which this Windows Hello for Business key resides. Supports $expand. When you get a user's
13815+ * Windows Hello for Business registration information, this property is returned only on a single GET and when you
13816+ * specify ?$expand. For example, GET
13817+ * /users/
[email protected] /authentication/windowsHelloForBusinessMethods/_jpuR-TGZtk6aQCLF3BQjA2?$expand=device.
13818+ */
1377813819 device?: NullableOption<Device>;
1377913820}
1378013821export interface AadUserConversationMember extends ConversationMember {
@@ -14383,9 +14424,12 @@ export interface AssignedPlan {
1438314424 * detailed description of each value.
1438414425 */
1438514426 capabilityStatus?: NullableOption<string>;
14386- // The name of the service; for example, 'Exchange' .
14427+ // The name of the service; for example, exchange .
1438714428 service?: NullableOption<string>;
14388- // A GUID that identifies the service plan.
14429+ /**
14430+ * A GUID that identifies the service plan. For a complete list of GUIDs and their equivalent friendly service names, see
14431+ * Product names and service plan identifiers for licensing.
14432+ */
1438914433 servicePlanId?: NullableOption<string>;
1439014434}
1439114435export interface EmployeeOrgData {
@@ -14811,6 +14855,18 @@ export interface PermissionScope {
1481114855 */
1481214856 value?: NullableOption<string>;
1481314857}
14858+ export interface ResourceSpecificPermission {
14859+ // Describes the level of access that the resource-specific permission represents.
14860+ description?: NullableOption<string>;
14861+ // The display name for the resource-specific permission.
14862+ displayName?: NullableOption<string>;
14863+ // The unique identifier for the resource-specific application permission.
14864+ id?: string;
14865+ // Indicates whether the permission is enabled.
14866+ isEnabled?: boolean;
14867+ // The value of the permission.
14868+ value?: NullableOption<string>;
14869+ }
1481414870export interface SamlSingleSignOnSettings {
1481514871 // The relative URI the service provider would redirect to after completion of the single sign-on flow.
1481614872 relayState?: NullableOption<string>;
@@ -15295,6 +15351,7 @@ export interface AlternativeSecurityId {
1529515351export interface PreAuthorizedApplication {
1529615352 // The unique identifier for the application.
1529715353 appId?: NullableOption<string>;
15354+ // The unique identifier for the oauth2PermissionScopes the application requires.
1529815355 delegatedPermissionIds?: string[];
1529915356}
1530015357export interface CertificateAuthority {
@@ -19586,10 +19643,15 @@ export interface RegistryKeyState {
1958619643 valueType?: NullableOption<RegistryValueType>;
1958719644}
1958819645export interface SecureScoreControlStateUpdate {
19646+ // Assigns the control to the user who will take the action.
1958919647 assignedTo?: NullableOption<string>;
19648+ // Provides optional comment about the control.
1959019649 comment?: NullableOption<string>;
19650+ // State of the control, which can be modified via a PATCH command (for example, ignored, thirdParty).
1959119651 state?: NullableOption<string>;
19652+ // ID of the user who updated tenant state.
1959219653 updatedBy?: NullableOption<string>;
19654+ // Time at which the control state was updated.
1959319655 updatedDateTime?: NullableOption<string>;
1959419656}
1959519657export interface SecurityResource {
@@ -20009,18 +20071,18 @@ export interface ChangeNotification {
2000920071 id?: NullableOption<string>;
2001020072 /**
2001120073 * The type of lifecycle notification if the current notification is a lifecycle notification. Optional. Supported values
20012- * are missed, subscriptionRemoved, reauthorizationRequired.
20074+ * are missed, subscriptionRemoved, reauthorizationRequired. Optional.
2001320075 */
2001420076 lifecycleEvent?: NullableOption<LifecycleEventType>;
2001520077 // The URI of the resource that emitted the change notification relative to https://graph.microsoft.com. Required.
2001620078 resource?: string;
20017- // The content of this property depends on the type of resource being subscribed to. Required .
20079+ // The content of this property depends on the type of resource being subscribed to. Optional .
2001820080 resourceData?: NullableOption<ResourceData>;
2001920081 // The expiration time for the subscription. Required.
2002020082 subscriptionExpirationDateTime?: string;
20021- // The unique identifier of the subscription that generated the notification.
20083+ // The unique identifier of the subscription that generated the notification.Required.
2002220084 subscriptionId?: string;
20023- // The unique identifier of the tenant from which the change notification originated.
20085+ // The unique identifier of the tenant from which the change notification originated. Required.
2002420086 tenantId?: string;
2002520087}
2002620088export interface ChangeNotificationEncryptedContent {
0 commit comments