From 5f3f98deb9c68459ac6f95859b7b0769ef314dff Mon Sep 17 00:00:00 2001 From: ramsessanchez <63934382+ramsessanchez@users.noreply.github.com> Date: Fri, 17 Apr 2026 14:22:11 -0700 Subject: [PATCH] update open api docs --- openApiDocs/v1.0/Applications.yml | 63 +++--- openApiDocs/v1.0/Compliance.yml | 9 +- .../v1.0/DeviceManagement.Administration.yml | 9 +- openApiDocs/v1.0/DeviceManagement.yml | 9 +- openApiDocs/v1.0/Devices.CloudPrint.yml | 9 +- .../v1.0/Devices.CorporateManagement.yml | 9 +- openApiDocs/v1.0/DirectoryObjects.yml | 2 +- openApiDocs/v1.0/Education.yml | 9 +- openApiDocs/v1.0/Files.yml | 9 +- openApiDocs/v1.0/Groups.yml | 25 ++- .../v1.0/Identity.DirectoryManagement.yml | 35 ++-- openApiDocs/v1.0/Identity.Governance.yml | 22 +- openApiDocs/v1.0/Identity.SignIns.yml | 21 +- openApiDocs/v1.0/Mail.yml | 12 -- openApiDocs/v1.0/Search.yml | 2 +- openApiDocs/v1.0/Security.yml | 26 ++- openApiDocs/v1.0/Sites.yml | 9 +- openApiDocs/v1.0/Teams.yml | 9 +- openApiDocs/v1.0/Users.Actions.yml | 11 +- openApiDocs/v1.0/Users.Functions.yml | 9 +- openApiDocs/v1.0/Users.yml | 190 +++++++++++++++--- 21 files changed, 361 insertions(+), 138 deletions(-) diff --git a/openApiDocs/v1.0/Applications.yml b/openApiDocs/v1.0/Applications.yml index 06f7b50e14..a96639d58e 100644 --- a/openApiDocs/v1.0/Applications.yml +++ b/openApiDocs/v1.0/Applications.yml @@ -11,7 +11,7 @@ paths: tags: - applications.application summary: List applications - description: Get the list of applications in this organization. + description: 'Get the list of applications in this organization. This API also returns agentIdentityBlueprint objects, which are identified by the @odata.type property of #microsoft.graph.agentIdentityBlueprint.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/application-list?view=graph-rest-1.0 @@ -75,7 +75,7 @@ paths: tags: - applications.application summary: Create application - description: Create a new application object. + description: 'Create a new application object. This API can also create an agentIdentityBlueprint object when the @odata.type property is set to #microsoft.graph.agentIdentityBlueprint.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/application-post-applications?view=graph-rest-1.0 @@ -102,7 +102,7 @@ paths: tags: - applications.application summary: Get application - description: Get the properties and relationships of an application object. + description: Get the properties and relationships of an application object. This API can be used to get agentIdentityBlueprint objects as well by their ID. externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/application-get?view=graph-rest-1.0 @@ -150,7 +150,7 @@ paths: tags: - applications.application summary: Upsert application - description: 'Create a new application object if it doesn''t exist, or update the properties of an existing application object.' + description: 'Create a new application object if it doesn''t exist, or update the properties of an existing application object. This API can also create an agentIdentityBlueprint object if it doesn''t exist, or update properties of an existing agentIdentityBlueprint, when the @odata.type property is set to #microsoft.graph.agentIdentityBlueprint.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/application-upsert?view=graph-rest-1.0 @@ -185,7 +185,7 @@ paths: tags: - applications.application summary: Delete application - description: 'Delete an application object. When deleted, apps are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted.' + description: 'Delete an application object. When deleted, apps are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted. This API can also delete an agentIdentityBlueprint object by its ID.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/application-delete?view=graph-rest-1.0 @@ -1654,10 +1654,10 @@ paths: tags: - applications.application.Actions summary: Invoke action removeKey - description: 'Remove a key credential from an application. This method along with addKey can be used by an application to automate rolling its expiring keys. As part of the request validation for this method, a proof of possession of an existing key is verified before the action can be performed.' + description: Remove a key credential from an agentIdentityBlueprint. This method along with addKey can be used to automate rolling its expiring keys. externalDocs: description: Find more info here - url: https://learn.microsoft.com/graph/api/application-removekey?view=graph-rest-1.0 + url: https://learn.microsoft.com/graph/api/agentidentityblueprint-removekey?view=graph-rest-1.0 operationId: application_removeKey parameters: - name: application-id @@ -1734,7 +1734,7 @@ paths: tags: - applications.application.Actions summary: Invoke action restore - description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." + description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-restore?view=graph-rest-1.0 @@ -1763,10 +1763,10 @@ paths: tags: - applications.application.Actions summary: Invoke action setVerifiedPublisher - description: 'Set the verifiedPublisher on an application. For more information, including prerequisites to setting a verified publisher, see Publisher verification.' + description: 'Set the the verifiedPublisher on an agentIdentityBlueprint. For more information, including prerequisites to setting a verified publisher, see Publisher verification.' externalDocs: description: Find more info here - url: https://learn.microsoft.com/graph/api/application-setverifiedpublisher?view=graph-rest-1.0 + url: https://learn.microsoft.com/graph/api/agentidentityblueprint-setverifiedpublisher?view=graph-rest-1.0 operationId: application_setVerifiedPublisher parameters: - name: application-id @@ -1800,10 +1800,10 @@ paths: tags: - applications.application.Actions summary: Invoke action unsetVerifiedPublisher - description: 'Unset the verifiedPublisher previously set on an application, removing all verified publisher properties. For more information, see Publisher verification.' + description: 'Unset the verifiedPublisher previously set on an agentIdentityBlueprint, removing all verified publisher properties. For more information, see Publisher verification.' externalDocs: description: Find more info here - url: https://learn.microsoft.com/graph/api/application-unsetverifiedpublisher?view=graph-rest-1.0 + url: https://learn.microsoft.com/graph/api/agentidentityblueprint-unsetverifiedpublisher?view=graph-rest-1.0 operationId: application_unsetVerifiedPublisher parameters: - name: application-id @@ -5756,7 +5756,7 @@ paths: tags: - applications.application summary: Get application - description: Get the properties and relationships of an application object. + description: Get the properties and relationships of an application object. This API can be used to get agentIdentityBlueprint objects as well by their ID. externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/application-get?view=graph-rest-1.0 @@ -5804,7 +5804,7 @@ paths: tags: - applications.application summary: Upsert application - description: 'Create a new application object if it doesn''t exist, or update the properties of an existing application object.' + description: 'Create a new application object if it doesn''t exist, or update the properties of an existing application object. This API can also create an agentIdentityBlueprint object if it doesn''t exist, or update properties of an existing agentIdentityBlueprint, when the @odata.type property is set to #microsoft.graph.agentIdentityBlueprint.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/application-upsert?view=graph-rest-1.0 @@ -5839,7 +5839,7 @@ paths: tags: - applications.application summary: Delete application - description: 'Delete an application object. When deleted, apps are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted.' + description: 'Delete an application object. When deleted, apps are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted. This API can also delete an agentIdentityBlueprint object by its ID.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/application-delete?view=graph-rest-1.0 @@ -5870,7 +5870,7 @@ paths: tags: - applications.application summary: Get application - description: Get the properties and relationships of an application object. + description: Get the properties and relationships of an application object. This API can be used to get agentIdentityBlueprint objects as well by their ID. externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/application-get?view=graph-rest-1.0 @@ -5918,7 +5918,7 @@ paths: tags: - applications.application summary: Upsert application - description: 'Create a new application object if it doesn''t exist, or update the properties of an existing application object.' + description: 'Create a new application object if it doesn''t exist, or update the properties of an existing application object. This API can also create an agentIdentityBlueprint object if it doesn''t exist, or update properties of an existing agentIdentityBlueprint, when the @odata.type property is set to #microsoft.graph.agentIdentityBlueprint.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/application-upsert?view=graph-rest-1.0 @@ -5953,7 +5953,7 @@ paths: tags: - applications.application summary: Delete application - description: 'Delete an application object. When deleted, apps are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted.' + description: 'Delete an application object. When deleted, apps are moved to a temporary container and can be restored within 30 days. After that time, they are permanently deleted. This API can also delete an agentIdentityBlueprint object by its ID.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/application-delete?view=graph-rest-1.0 @@ -6666,7 +6666,7 @@ paths: tags: - servicePrincipals.servicePrincipal summary: List servicePrincipals - description: Retrieve a list of servicePrincipal objects. + description: 'Retrieve a list of servicePrincipal objects. This API also returns agentIdentityBlueprintPrincipal objects, which are identified by the @odata.type property of #microsoft.graph.agentIdentityBlueprintPrincipal.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/serviceprincipal-list?view=graph-rest-1.0 @@ -6730,7 +6730,7 @@ paths: tags: - servicePrincipals.servicePrincipal summary: Create servicePrincipal - description: Create a new servicePrincipal object. + description: 'Create a new servicePrincipal object. This API can also create an agentIdentityBlueprintPrincipal object from an agentIdentityBlueprint when the @odata.type property is set to #microsoft.graph.agentIdentityBlueprintPrincipal.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/serviceprincipal-post-serviceprincipals?view=graph-rest-1.0 @@ -6757,7 +6757,7 @@ paths: tags: - servicePrincipals.servicePrincipal summary: Get servicePrincipal - description: Retrieve the properties and relationships of a servicePrincipal object. + description: Retrieve the properties and relationships of a servicePrincipal object. This API can be used to get agentIdentityBlueprintPrincipal objects as well by their ID. externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/serviceprincipal-get?view=graph-rest-1.0 @@ -6805,7 +6805,7 @@ paths: tags: - servicePrincipals.servicePrincipal summary: Upsert servicePrincipal - description: 'Create a new servicePrincipal object if it doesn''t exist, or update the properties of an existing servicePrincipal object.' + description: 'Create a new servicePrincipal object if it doesn''t exist, or update the properties of an existing servicePrincipal object. This API can also create an agentIdentityBlueprintPrincipal object from an agentIdentityBlueprint if it doesn''t exist, or update properties of an existing agentIdentityBlueprintPrincipal, when the @odata.type property is set to #microsoft.graph.agentIdentityBlueprintPrincipal.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/serviceprincipal-upsert?view=graph-rest-1.0 @@ -6840,7 +6840,7 @@ paths: tags: - servicePrincipals.servicePrincipal summary: Delete servicePrincipal - description: Delete a servicePrincipal object. + description: Delete a servicePrincipal object. This API can also delete an agentIdentityBlueprintPrincipal object by its ID. externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/serviceprincipal-delete?view=graph-rest-1.0 @@ -10208,7 +10208,7 @@ paths: tags: - servicePrincipals.servicePrincipal.Actions summary: Invoke action restore - description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." + description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-restore?view=graph-rest-1.0 @@ -16132,7 +16132,7 @@ paths: tags: - servicePrincipals.servicePrincipal summary: Get servicePrincipal - description: Retrieve the properties and relationships of a servicePrincipal object. + description: Retrieve the properties and relationships of a servicePrincipal object. This API can be used to get agentIdentityBlueprintPrincipal objects as well by their ID. externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/serviceprincipal-get?view=graph-rest-1.0 @@ -16180,7 +16180,7 @@ paths: tags: - servicePrincipals.servicePrincipal summary: Upsert servicePrincipal - description: 'Create a new servicePrincipal object if it doesn''t exist, or update the properties of an existing servicePrincipal object.' + description: 'Create a new servicePrincipal object if it doesn''t exist, or update the properties of an existing servicePrincipal object. This API can also create an agentIdentityBlueprintPrincipal object from an agentIdentityBlueprint if it doesn''t exist, or update properties of an existing agentIdentityBlueprintPrincipal, when the @odata.type property is set to #microsoft.graph.agentIdentityBlueprintPrincipal.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/serviceprincipal-upsert?view=graph-rest-1.0 @@ -16215,7 +16215,7 @@ paths: tags: - servicePrincipals.servicePrincipal summary: Delete servicePrincipal - description: Delete a servicePrincipal object. + description: Delete a servicePrincipal object. This API can also delete an agentIdentityBlueprintPrincipal object by its ID. externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/serviceprincipal-delete?view=graph-rest-1.0 @@ -18663,10 +18663,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -18699,6 +18701,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: @@ -19908,7 +19913,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -23280,7 +23285,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: diff --git a/openApiDocs/v1.0/Compliance.yml b/openApiDocs/v1.0/Compliance.yml index b5616c4edb..b785ce6cb1 100644 --- a/openApiDocs/v1.0/Compliance.yml +++ b/openApiDocs/v1.0/Compliance.yml @@ -3169,7 +3169,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -5586,10 +5586,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -5622,6 +5624,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: @@ -6364,7 +6369,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: diff --git a/openApiDocs/v1.0/DeviceManagement.Administration.yml b/openApiDocs/v1.0/DeviceManagement.Administration.yml index 88ed601a00..17814c0a5b 100644 --- a/openApiDocs/v1.0/DeviceManagement.Administration.yml +++ b/openApiDocs/v1.0/DeviceManagement.Administration.yml @@ -9099,7 +9099,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -11918,7 +11918,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: @@ -13878,10 +13878,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -13914,6 +13916,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: diff --git a/openApiDocs/v1.0/DeviceManagement.yml b/openApiDocs/v1.0/DeviceManagement.yml index e17c2909d2..a44516b29a 100644 --- a/openApiDocs/v1.0/DeviceManagement.yml +++ b/openApiDocs/v1.0/DeviceManagement.yml @@ -18641,7 +18641,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -21180,7 +21180,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: @@ -23128,10 +23128,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -23164,6 +23166,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: diff --git a/openApiDocs/v1.0/Devices.CloudPrint.yml b/openApiDocs/v1.0/Devices.CloudPrint.yml index 08eca17f86..489fe7d73c 100644 --- a/openApiDocs/v1.0/Devices.CloudPrint.yml +++ b/openApiDocs/v1.0/Devices.CloudPrint.yml @@ -7032,10 +7032,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -7068,6 +7070,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: @@ -9713,7 +9718,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -13987,7 +13992,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: diff --git a/openApiDocs/v1.0/Devices.CorporateManagement.yml b/openApiDocs/v1.0/Devices.CorporateManagement.yml index b989cedd64..c7feabcbcb 100644 --- a/openApiDocs/v1.0/Devices.CorporateManagement.yml +++ b/openApiDocs/v1.0/Devices.CorporateManagement.yml @@ -37773,7 +37773,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -39845,7 +39845,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: @@ -41812,10 +41812,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -41848,6 +41850,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: diff --git a/openApiDocs/v1.0/DirectoryObjects.yml b/openApiDocs/v1.0/DirectoryObjects.yml index 5856524afc..31044b3192 100644 --- a/openApiDocs/v1.0/DirectoryObjects.yml +++ b/openApiDocs/v1.0/DirectoryObjects.yml @@ -1004,7 +1004,7 @@ paths: tags: - directoryObjects.directoryObject.Actions summary: Invoke action restore - description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." + description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-restore?view=graph-rest-1.0 diff --git a/openApiDocs/v1.0/Education.yml b/openApiDocs/v1.0/Education.yml index 397bf0f79f..19e758b32c 100644 --- a/openApiDocs/v1.0/Education.yml +++ b/openApiDocs/v1.0/Education.yml @@ -19271,10 +19271,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -19307,6 +19309,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: @@ -22418,7 +22423,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -26326,7 +26331,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: diff --git a/openApiDocs/v1.0/Files.yml b/openApiDocs/v1.0/Files.yml index e85e9b6d5f..f77dd7813a 100644 --- a/openApiDocs/v1.0/Files.yml +++ b/openApiDocs/v1.0/Files.yml @@ -79025,7 +79025,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -82509,7 +82509,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: @@ -83799,10 +83799,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -83835,6 +83837,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: diff --git a/openApiDocs/v1.0/Groups.yml b/openApiDocs/v1.0/Groups.yml index 9afc984ab9..f363fbf730 100644 --- a/openApiDocs/v1.0/Groups.yml +++ b/openApiDocs/v1.0/Groups.yml @@ -3987,8 +3987,8 @@ paths: get: tags: - groups.directoryObject - summary: List memberOf - description: 'Get groups that the group is a direct member of. This operation is not transitive. Unlike getting a user''s Microsoft 365 groups, this returns all types of groups, not just Microsoft 365 groups.' + summary: List group memberships + description: 'Get security groups, administrative units, and admin roles that the security group is a direct member of, or administrative units and admin roles that the Microsoft 365 group is a direct member of. This operation is not transitive.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/group-list-memberof?view=graph-rest-1.0 @@ -4186,8 +4186,8 @@ paths: get: tags: - groups.directoryObject - summary: List memberOf - description: 'Get groups that the group is a direct member of. This operation is not transitive. Unlike getting a user''s Microsoft 365 groups, this returns all types of groups, not just Microsoft 365 groups.' + summary: List group memberships + description: 'Get security groups, administrative units, and admin roles that the security group is a direct member of, or administrative units and admin roles that the Microsoft 365 group is a direct member of. This operation is not transitive.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/group-list-memberof?view=graph-rest-1.0 @@ -4384,8 +4384,8 @@ paths: get: tags: - groups.directoryObject - summary: List memberOf - description: 'Get groups that the group is a direct member of. This operation is not transitive. Unlike getting a user''s Microsoft 365 groups, this returns all types of groups, not just Microsoft 365 groups.' + summary: List group memberships + description: 'Get security groups, administrative units, and admin roles that the security group is a direct member of, or administrative units and admin roles that the Microsoft 365 group is a direct member of. This operation is not transitive.' externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/group-list-memberof?view=graph-rest-1.0 @@ -7276,7 +7276,7 @@ paths: tags: - groups.group.Actions summary: Invoke action restore - description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." + description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-restore?view=graph-rest-1.0 @@ -14910,7 +14910,7 @@ paths: tags: - groupSettingTemplates.groupSettingTemplate.Actions summary: Invoke action restore - description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." + description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-restore?view=graph-rest-1.0 @@ -15344,10 +15344,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -15380,6 +15382,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: @@ -19392,7 +19397,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -23301,7 +23306,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: diff --git a/openApiDocs/v1.0/Identity.DirectoryManagement.yml b/openApiDocs/v1.0/Identity.DirectoryManagement.yml index 867a8d4d69..987c6968fc 100644 --- a/openApiDocs/v1.0/Identity.DirectoryManagement.yml +++ b/openApiDocs/v1.0/Identity.DirectoryManagement.yml @@ -1839,7 +1839,7 @@ paths: tags: - contacts.orgContact.Actions summary: Invoke action restore - description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." + description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-restore?view=graph-rest-1.0 @@ -1868,6 +1868,10 @@ paths: tags: - contacts.orgContact.Actions summary: Invoke action retryServiceProvisioning + description: Retry the orgContact service provisioning. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/orgcontact-retryserviceprovisioning?view=graph-rest-1.0 operationId: contact_retryServiceProvisioning parameters: - name: orgContact-id @@ -3216,7 +3220,7 @@ paths: tags: - contracts.contract.Actions summary: Invoke action restore - description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." + description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-restore?view=graph-rest-1.0 @@ -4639,7 +4643,7 @@ paths: tags: - devices.device.Actions summary: Invoke action restore - description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." + description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-restore?view=graph-rest-1.0 @@ -10102,7 +10106,7 @@ paths: tags: - directory.directoryObject summary: Get deleted item (directory object) - description: "Retrieve the properties of a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Retrieve the properties of a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user" + description: "Retrieve the properties of a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Retrieve the properties of a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user" operationId: directory_ListDeletedItem parameters: - $ref: '#/components/parameters/top' @@ -10154,7 +10158,7 @@ paths: tags: - directory.directoryObject summary: Get deleted item (directory object) - description: "Retrieve the properties of a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Retrieve the properties of a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user" + description: "Retrieve the properties of a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Retrieve the properties of a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user" externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-get?view=graph-rest-1.0 @@ -10585,7 +10589,7 @@ paths: tags: - directory.directoryObject summary: List deletedItems (directory objects) - description: "Retrieve a list of recently deleted directory objects. Currently, deleted items functionality is only supported for the application, servicePrincipal, group, administrative unit, and user resources. Retrieve a list of recently deleted directory objects from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user" + description: "Retrieve a list of recently deleted directory objects. Currently, deleted items functionality is only supported for the application, servicePrincipal, group, administrative unit, and user resources. Retrieve a list of recently deleted directory objects from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user" externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-list?view=graph-rest-1.0 @@ -10633,7 +10637,7 @@ paths: tags: - directory.directoryObject summary: Invoke action restore - description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." + description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-restore?view=graph-rest-1.0 @@ -11057,7 +11061,7 @@ paths: tags: - directory.directoryObject summary: List deletedItems (directory objects) - description: "Retrieve a list of recently deleted directory objects. Currently, deleted items functionality is only supported for the application, servicePrincipal, group, administrative unit, and user resources. Retrieve a list of recently deleted directory objects from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user" + description: "Retrieve a list of recently deleted directory objects. Currently, deleted items functionality is only supported for the application, servicePrincipal, group, administrative unit, and user resources. Retrieve a list of recently deleted directory objects from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user" externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-list?view=graph-rest-1.0 @@ -14446,7 +14450,7 @@ paths: tags: - directoryRoles.directoryRole.Actions summary: Invoke action restore - description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." + description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-restore?view=graph-rest-1.0 @@ -15455,7 +15459,7 @@ paths: tags: - directoryRoleTemplates.directoryRoleTemplate.Actions summary: Invoke action restore - description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." + description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-restore?view=graph-rest-1.0 @@ -19942,7 +19946,7 @@ paths: tags: - organization.organization.Actions summary: Invoke action restore - description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." + description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-restore?view=graph-rest-1.0 @@ -21604,10 +21608,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -21640,6 +21646,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: @@ -23873,7 +23882,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -28005,7 +28014,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: diff --git a/openApiDocs/v1.0/Identity.Governance.yml b/openApiDocs/v1.0/Identity.Governance.yml index f4b68ce9d5..16de848f37 100644 --- a/openApiDocs/v1.0/Identity.Governance.yml +++ b/openApiDocs/v1.0/Identity.Governance.yml @@ -7584,7 +7584,7 @@ paths: tags: - identityGovernance.entitlementManagement summary: Get accessPackage from identityGovernance - description: Access package containing this policy. Read-only. Supports $expand. + description: Access package containing this policy. Read-only. Supports $expand. operationId: identityGovernance.entitlementManagement.accessPackage.assignmentPolicy_GetAccessPackage parameters: - name: accessPackage-id @@ -12525,7 +12525,7 @@ paths: tags: - identityGovernance.entitlementManagement summary: Get accessPackage from identityGovernance - description: Access package containing this policy. Read-only. Supports $expand. + description: Access package containing this policy. Read-only. Supports $expand. operationId: identityGovernance.entitlementManagement.assignmentPolicy_GetAccessPackage parameters: - name: accessPackageAssignmentPolicy-id @@ -38794,6 +38794,7 @@ paths: tags: - identityGovernance.lifecycleWorkflowsContainer summary: Get administrationScopeTargets from identityGovernance + description: The administrative units in the scope of the workflow. Optional. Supports $expand. operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_ListAdministrationScopeTarget parameters: - name: workflow-id @@ -38853,6 +38854,7 @@ paths: tags: - identityGovernance.lifecycleWorkflowsContainer summary: Get administrationScopeTargets from identityGovernance + description: The administrative units in the scope of the workflow. Optional. Supports $expand. operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow_GetAdministrationScopeTarget parameters: - name: workflow-id @@ -44750,6 +44752,7 @@ paths: tags: - identityGovernance.lifecycleWorkflowsContainer summary: Get administrationScopeTargets from identityGovernance + description: The administrative units in the scope of the workflow. Optional. Supports $expand. operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow.version_ListAdministrationScopeTarget parameters: - name: workflow-id @@ -44820,6 +44823,7 @@ paths: tags: - identityGovernance.lifecycleWorkflowsContainer summary: Get administrationScopeTargets from identityGovernance + description: The administrative units in the scope of the workflow. Optional. Supports $expand. operationId: identityGovernance.lifecycleWorkflow.deletedItem.workflow.version_GetAdministrationScopeTarget parameters: - name: workflow-id @@ -47096,6 +47100,7 @@ paths: tags: - identityGovernance.lifecycleWorkflowsContainer summary: Get administrationScopeTargets from identityGovernance + description: The administrative units in the scope of the workflow. Optional. Supports $expand. operationId: identityGovernance.lifecycleWorkflow.workflow_ListAdministrationScopeTarget parameters: - name: workflow-id @@ -47155,6 +47160,7 @@ paths: tags: - identityGovernance.lifecycleWorkflowsContainer summary: Get administrationScopeTargets from identityGovernance + description: The administrative units in the scope of the workflow. Optional. Supports $expand. operationId: identityGovernance.lifecycleWorkflow.workflow_GetAdministrationScopeTarget parameters: - name: workflow-id @@ -53096,6 +53102,7 @@ paths: tags: - identityGovernance.lifecycleWorkflowsContainer summary: Get administrationScopeTargets from identityGovernance + description: The administrative units in the scope of the workflow. Optional. Supports $expand. operationId: identityGovernance.lifecycleWorkflow.workflow.version_ListAdministrationScopeTarget parameters: - name: workflow-id @@ -53166,6 +53173,7 @@ paths: tags: - identityGovernance.lifecycleWorkflowsContainer summary: Get administrationScopeTargets from identityGovernance + description: The administrative units in the scope of the workflow. Optional. Supports $expand. operationId: identityGovernance.lifecycleWorkflow.workflow.version_GetAdministrationScopeTarget parameters: - name: workflow-id @@ -73307,10 +73315,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -73343,6 +73353,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: @@ -75280,7 +75293,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -77469,6 +77482,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.directoryObject' + description: The administrative units in the scope of the workflow. Optional. Supports $expand. x-ms-navigationProperty: true createdBy: $ref: '#/components/schemas/microsoft.graph.user' @@ -79149,7 +79163,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: diff --git a/openApiDocs/v1.0/Identity.SignIns.yml b/openApiDocs/v1.0/Identity.SignIns.yml index b4e8807891..af711c434e 100644 --- a/openApiDocs/v1.0/Identity.SignIns.yml +++ b/openApiDocs/v1.0/Identity.SignIns.yml @@ -17867,7 +17867,11 @@ paths: patch: tags: - tenantRelationships.multiTenantOrganization - summary: Update the navigation property tenants in tenantRelationships + summary: Update multiTenantOrganizationMember + description: Update the properties of a tenant in a multitenant organization. Only owner tenants can call this API. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/multitenantorganizationmember-update?view=graph-rest-1.0 operationId: tenantRelationship.multiTenantOrganization_UpdateTenant parameters: - name: multiTenantOrganizationMember-id @@ -18299,7 +18303,7 @@ paths: tags: - users.authentication summary: Get externalAuthenticationMethods from users - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. operationId: user.authentication_ListExternalAuthenticationMethod parameters: - name: user-id @@ -18394,7 +18398,7 @@ paths: tags: - users.authentication summary: Get externalAuthenticationMethods from users - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. operationId: user.authentication_GetExternalAuthenticationMethod parameters: - name: user-id @@ -21287,6 +21291,7 @@ components: - federatedSingleFactor - federatedMultiFactor - unknownFutureValue + - qrCodePin type: string x-ms-enum-flags: isFlags: true @@ -23483,7 +23488,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -23570,7 +23575,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: @@ -24142,6 +24147,7 @@ components: - x509Certificate - federation - unknownFutureValue + - qrCodePin type: string microsoft.graph.authenticationStrengthPolicyType: title: authenticationStrengthPolicyType @@ -30986,10 +30992,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -31022,6 +31030,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: diff --git a/openApiDocs/v1.0/Mail.yml b/openApiDocs/v1.0/Mail.yml index 1f54f6dafc..1520f953c8 100644 --- a/openApiDocs/v1.0/Mail.yml +++ b/openApiDocs/v1.0/Mail.yml @@ -2453,10 +2453,6 @@ paths: tags: - users.mailFolder summary: Invoke action createForward - description: "Create a draft to forward an existing message, in either JSON or MIME format. When using JSON format, you can:\r\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\r\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error.\r\n- Update the draft later to add content to the body or change other message properties. When using MIME format:\r\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\r\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, forward a message in a single operation." - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/message-createforward?view=graph-rest-1.0 operationId: user.mailFolder.childFolder.message_createForward parameters: - name: user-id @@ -4833,10 +4829,6 @@ paths: tags: - users.mailFolder summary: Invoke action createForward - description: "Create a draft to forward an existing message, in either JSON or MIME format. When using JSON format, you can:\r\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\r\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error.\r\n- Update the draft later to add content to the body or change other message properties. When using MIME format:\r\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\r\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, forward a message in a single operation." - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/message-createforward?view=graph-rest-1.0 operationId: user.mailFolder.message_createForward parameters: - name: user-id @@ -6643,10 +6635,6 @@ paths: tags: - users.message summary: Invoke action createForward - description: "Create a draft to forward an existing message, in either JSON or MIME format. When using JSON format, you can:\r\n- Specify either a comment or the body property of the message parameter. Specifying both will return an HTTP 400 Bad Request error.\r\n- Specify either the toRecipients parameter or the toRecipients property of the message parameter. Specifying both or specifying neither will return an HTTP 400 Bad Request error.\r\n- Update the draft later to add content to the body or change other message properties. When using MIME format:\r\n- Provide the applicable Internet message headers and the MIME content, all encoded in base64 format in the request body.\r\n- Add any attachments and S/MIME properties to the MIME content. Send the draft message in a subsequent operation. Alternatively, forward a message in a single operation." - externalDocs: - description: Find more info here - url: https://learn.microsoft.com/graph/api/message-createforward?view=graph-rest-1.0 operationId: user.message_createForward parameters: - name: user-id diff --git a/openApiDocs/v1.0/Search.yml b/openApiDocs/v1.0/Search.yml index 4cddf0d0b1..cab635d481 100644 --- a/openApiDocs/v1.0/Search.yml +++ b/openApiDocs/v1.0/Search.yml @@ -3127,7 +3127,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalConnectors.label' - description: 'Specifies one or more well-known tags added against a property. Labels help Microsoft Search understand the semantics of the data in the connection. Adding appropriate labels would result in an enhanced search experience (for example, better relevance). Optional.The possible values are: title, url, createdBy, lastModifiedBy, authors, createdDateTime, lastModifiedDateTime, fileName, fileExtension, unknownFutureValue, iconUrl. Use the Prefer: include-unknown-enum-members request header to get the following members in this evolvable enum: iconUrl.' + description: 'Specifies one or more well-known tags added against a property. Labels help Microsoft Search understand the semantics of the data in the connection. Adding appropriate labels would result in an enhanced search experience (for example, better relevance). Optional..The possible values are: title, url, createdBy, lastModifiedBy, authors, createdDateTime, lastModifiedDateTime, fileName, fileExtension, unknownFutureValue, containerName, containerUrl, iconUrl, assignedTo, dueDate, closedDate, closedBy, reportedBy, sprintName, severity, state, priority, secondaryId, itemParentId, parentUrl, tags, itemType, itemPath, numReactions. Use the Prefer: include-unknown-enum-members request header to retrieve additional values defined in this evolvable enum,For People Connectors you can include : personEmails, personAddresses, personAnniversaries, personName, personNote, personPhones, personCurrentPosition, personWebAccounts, personWebSite, personSkills, personProjects, personAccount, personAwards, personCertifications, personAssistants, personColleagues, personManager, personAlternateContacts, personEmergencyContacts.' name: type: string description: 'The name of the property. Maximum 32 characters. Only alphanumeric characters allowed. For example, each string may not contain control characters, whitespace, or any of the following: :, ;, ,, (, ), [, ], {, }, %, $, +, !, *, =, &, ?, @, #, /, ~, '', '', <, >, `, ^. Required.' diff --git a/openApiDocs/v1.0/Security.yml b/openApiDocs/v1.0/Security.yml index 6b4a570437..92365996b0 100644 --- a/openApiDocs/v1.0/Security.yml +++ b/openApiDocs/v1.0/Security.yml @@ -69,7 +69,7 @@ paths: get: tags: - security.alert - summary: List alerts + summary: List alerts (deprecated) description: Retrieve a list of alert objects. externalDocs: description: Find more info here @@ -426,7 +426,7 @@ paths: get: tags: - security.alert - summary: Get alert + summary: Get alert (deprecated) description: Retrieve the properties and relationships of an alert object. externalDocs: description: Find more info here @@ -480,7 +480,7 @@ paths: patch: tags: - security.alert - summary: Update alert + summary: Update alert (deprecated) description: Update an editable alert property within any integrated solution to keep alert status and assignments in sync across solutions. This method updates any solution that has a record of the referenced alert ID. externalDocs: description: Find more info here @@ -23113,7 +23113,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.fileSecurityState' - description: Security-related stateful information generated by the provider about the file(s) related to this alert. + description: Security-related stateful information generated by the provider about the files related to this alert. historyStates: type: array items: @@ -23122,7 +23122,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.hostSecurityState' - description: Security-related stateful information generated by the provider about the host(s) related to this alert. + description: Security-related stateful information generated by the provider about the hosts related to this alert. incidentIds: type: array items: @@ -23157,7 +23157,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.networkConnection' - description: Security-related stateful information generated by the provider about the network connection(s) related to this alert. + description: Security-related stateful information generated by the provider about the network connections related to this alert. processes: type: array items: @@ -23168,7 +23168,7 @@ components: items: type: string nullable: true - description: 'Vendor/provider recommended action(s) to take as a result of the alert (for example, isolate machine, enforce2FA, reimage host).' + description: 'Vendor/provider recommended actions to take as a result of the alert (for example, isolate machine, enforce2FA, reimage host).' registryKeyStates: type: array items: @@ -23194,7 +23194,7 @@ components: items: type: string nullable: true - description: 'User-definable labels that can be applied to an alert and can serve as filter conditions (for example ''HVA'', ''SAW'') (supports update).' + description: 'User-definable labels that can be applied to an alert and can serve as filter conditions (for example, ''HVA'', ''SAW'') (supports update).' title: type: string description: Alert title. Required. @@ -24416,10 +24416,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -24452,6 +24454,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: @@ -31359,7 +31364,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -36908,7 +36913,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: @@ -40975,6 +40980,7 @@ components: - sPRuntimeAccessControl - sPSharingNotifyUser - sPSharingGenerateIncidentReport + - restrictWebGrounding type: string microsoft.graph.classificationError: allOf: diff --git a/openApiDocs/v1.0/Sites.yml b/openApiDocs/v1.0/Sites.yml index 5fca11e976..81b47034c8 100644 --- a/openApiDocs/v1.0/Sites.yml +++ b/openApiDocs/v1.0/Sites.yml @@ -119382,7 +119382,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -122934,7 +122934,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: @@ -124224,10 +124224,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -124260,6 +124262,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: diff --git a/openApiDocs/v1.0/Teams.yml b/openApiDocs/v1.0/Teams.yml index 03c7f436da..ec638192d9 100644 --- a/openApiDocs/v1.0/Teams.yml +++ b/openApiDocs/v1.0/Teams.yml @@ -63478,10 +63478,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -63514,6 +63516,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: @@ -69951,7 +69956,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -72911,7 +72916,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: diff --git a/openApiDocs/v1.0/Users.Actions.yml b/openApiDocs/v1.0/Users.Actions.yml index 3e71ffec6d..caf485cb16 100644 --- a/openApiDocs/v1.0/Users.Actions.yml +++ b/openApiDocs/v1.0/Users.Actions.yml @@ -416,7 +416,7 @@ paths: tags: - users.user.Actions summary: Invoke action restore - description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." + description: "Restore a recently deleted application, group, servicePrincipal, administrative unit, or user object from deleted items. Restore a recently deleted directory object from deleted items. The following types are supported:\r\n- administrativeUnit\r\n- application\r\n- agentIdentityBlueprint\r\n- agentIdentity\r\n- agentIdentityBlueprintPrincipal\r\n- certificateBasedAuthPki\r\n- certificateAuthorityDetail\r\n- group\r\n- servicePrincipal\r\n- user If an item is accidentally deleted, you can fully restore the item. Additionally, restoring an application doesn't automatically restore the associated service principal automatically. You must call this API to explicitly restore the deleted service principal. A recently deleted item remains available for up to 30 days. After 30 days, the item is permanently deleted." externalDocs: description: Find more info here url: https://learn.microsoft.com/graph/api/directory-deleteditems-restore?view=graph-rest-1.0 @@ -2408,7 +2408,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -4844,7 +4844,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: @@ -6640,10 +6640,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -6676,6 +6678,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: diff --git a/openApiDocs/v1.0/Users.Functions.yml b/openApiDocs/v1.0/Users.Functions.yml index ec6722fcbb..f1df2b29cf 100644 --- a/openApiDocs/v1.0/Users.Functions.yml +++ b/openApiDocs/v1.0/Users.Functions.yml @@ -1472,7 +1472,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -3972,7 +3972,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: @@ -5939,10 +5939,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -5975,6 +5977,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: diff --git a/openApiDocs/v1.0/Users.yml b/openApiDocs/v1.0/Users.yml index 8782c8e049..670535eab2 100644 --- a/openApiDocs/v1.0/Users.yml +++ b/openApiDocs/v1.0/Users.yml @@ -8473,13 +8473,16 @@ paths: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation - '/users/{user-id}/sponsors/{directoryObject-id}': - get: + '/users/{user-id}/sponsors/{directoryObject-id}/$ref': + delete: tags: - users.directoryObject - summary: Get sponsors from users - description: 'The users and groups responsible for this guest''s privileges in the tenant and keeping the guest''s information and access updated. (HTTP Methods: GET, POST, DELETE.). Supports $expand.' - operationId: user_GetSponsor + summary: Remove sponsor + description: Remove a user's sponsor. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-sponsors?view=graph-rest-1.0 + operationId: user.sponsor_DeleteDirectoryObjectGraphBPreRef parameters: - name: user-id in: path @@ -8497,19 +8500,67 @@ paths: schema: type: string x-ms-docs-key-type: directoryObject - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false + - name: If-Match + in: header + description: ETag + style: simple schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand + type: string + responses: + 2XX: + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/users/{user-id}/sponsors/$count': + get: + tags: + - users.directoryObject + summary: Get the number of the resource + operationId: user.sponsor_GetCount + parameters: + - name: user-id + in: path + description: The unique identifier of user + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: user + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + 2XX: + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/users/{user-id}/sponsors/$ref': + get: + tags: + - users.directoryObject + summary: List sponsors + description: Get a user's sponsors. Sponsors are users and groups that are responsible for this guest's privileges in the tenant and for keeping the guest's information and access up to date. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-sponsors?view=graph-rest-1.0 + operationId: user_ListSponsorGraphBPreRef + parameters: + - name: user-id + in: path + description: The unique identifier of user + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: user + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby in: query - description: Expand related entities + description: Order items by property values style: form explode: false schema: @@ -8519,20 +8570,22 @@ paths: type: string responses: 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.directoryObject' + $ref: '#/components/responses/StringCollectionResponse' default: $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore x-ms-docs-operation-type: operation - '/users/{user-id}/sponsors/$count': - get: + post: tags: - users.directoryObject - summary: Get the number of the resource - operationId: user.sponsor_GetCount + summary: Add sponsor + description: Assign a user a sponsor. Sponsors are users and groups that are responsible for this guest user's privileges in the tenant and for keeping the guest user's information and access up to date. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-sponsors?view=graph-rest-1.0 + operationId: user_CreateSponsorGraphBPreRef parameters: - name: user-id in: path @@ -8542,13 +8595,52 @@ paths: schema: type: string x-ms-docs-key-type: user - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' + requestBody: + $ref: '#/components/requestBodies/refPostBody' responses: 2XX: - $ref: '#/components/responses/ODataCountResponse' + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - users.directoryObject + summary: Remove sponsor + description: Remove a user's sponsor. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-sponsors?view=graph-rest-1.0 + operationId: user_DeleteSponsorGraphBPreRef + parameters: + - name: user-id + in: path + description: The unique identifier of user + required: true + style: simple + schema: + type: string + x-ms-docs-key-type: user + - name: If-Match + in: header + description: ETag + style: simple + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + style: form + explode: false + schema: + type: string + responses: + 2XX: + description: Success default: $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation '/users/{user-id}/todo': get: tags: @@ -13722,10 +13814,12 @@ components: type: array items: type: string + description: 'Specifies the group behaviors that can be set for a Microsoft 365 group during creation. This property can be set only as part of creation (POST). For the list of possible values, see Microsoft 365 group behaviors and provisioning options.' resourceProvisioningOptions: type: array items: type: string + description: 'Specifies the group resources that are associated with the Microsoft 365 group. The possible value is Team. For more information, see Microsoft 365 group behaviors and provisioning options. Returned by default. Supports $filter (eq, not, startsWith).' securityEnabled: type: boolean description: 'Specifies whether the group is a security group. Required. Returned by default. Supports $filter (eq, ne, not, in).' @@ -13758,6 +13852,9 @@ components: type: string description: 'Specifies the group join policy and group content visibility for groups. The possible values are: Private, Public, or HiddenMembership. HiddenMembership can be set only for Microsoft 365 groups when the groups are created. It can''t be updated later. Other values of visibility can be updated after group creation. If visibility value isn''t specified during group creation on Microsoft Graph, a security group is created as Private by default, and the Microsoft 365 group is Public. Groups assignable to roles are always Private. To learn more, see group visibility options. Returned by default. Nullable.' nullable: true + welcomeMessageEnabled: + type: boolean + nullable: true acceptedSenders: type: array items: @@ -15435,7 +15532,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.externalAuthenticationMethod' - description: Represents the external authentication methods registered to a user for authentication using an external identity provider. + description: Represents the external MFA registered to a user for authentication using an external identity provider. x-ms-navigationProperty: true fido2Methods: type: array @@ -18655,6 +18752,13 @@ components: nullable: true additionalProperties: type: object + ReferenceCreate: + type: object + properties: + '@odata.id': + type: string + additionalProperties: + type: object microsoft.graph.userCollectionResponse: title: Collection of user type: object @@ -18979,6 +19083,19 @@ components: nullable: true additionalProperties: type: object + StringCollectionResponse: + title: Collection of string + type: object + properties: + value: + type: array + items: + type: string + '@odata.nextLink': + type: string + nullable: true + additionalProperties: + type: object microsoft.graph.todoTaskListCollectionResponse: title: Collection of todoTaskList type: object @@ -19297,7 +19414,7 @@ components: description: A unique identifier used to manage the external auth method within Microsoft Entra ID. displayName: type: string - description: Custom name given to the registered external authentication method. + description: Custom name given to the registered external MFA. additionalProperties: type: object microsoft.graph.fido2AuthenticationMethod: @@ -32298,6 +32415,12 @@ components: application/json: schema: $ref: '#/components/schemas/microsoft.graph.workPlanRecurrenceCollectionResponse' + StringCollectionResponse: + description: Retrieved collection + content: + application/json: + schema: + $ref: '#/components/schemas/StringCollectionResponse' microsoft.graph.todoTaskListCollectionResponse: description: Retrieved collection content: @@ -32386,6 +32509,13 @@ components: schema: $ref: '#/components/schemas/ReferenceUpdate' required: true + refPostBody: + description: New navigation property ref value + content: + application/json: + schema: + $ref: '#/components/schemas/ReferenceCreate' + required: true securitySchemes: azureaadv2: type: oauth2