From 3af4ca67b396162bbcdec4c6e2e5a2891adcca9b Mon Sep 17 00:00:00 2001 From: Microsoft Graph DevX Tooling Date: Tue, 17 Mar 2026 10:48:42 +0000 Subject: [PATCH] Update clean v1.0 metadata file with 212896 --- openapi/v1.0/default.yaml | 380 +++++++++++++++++++----------- openapi/v1.0/graphexplorer.yaml | 392 ++++++++++++++++++++----------- openapi/v1.0/openapi.yaml | 396 ++++++++++++++++++++----------- openapi/v1.0/powershell_v2.yaml | 398 +++++++++++++++++++++----------- 4 files changed, 1014 insertions(+), 552 deletions(-) diff --git a/openapi/v1.0/default.yaml b/openapi/v1.0/default.yaml index 3763fd495..7921d96af 100644 --- a/openapi/v1.0/default.yaml +++ b/openapi/v1.0/default.yaml @@ -6895,7 +6895,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 @@ -6958,7 +6958,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 @@ -6986,7 +6986,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 @@ -7033,7 +7033,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 @@ -7063,7 +7063,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 @@ -8478,10 +8478,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: applications.application.removeKey parameters: - name: application-id @@ -8554,7 +8554,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 @@ -8586,10 +8586,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: applications.application.setVerifiedPublisher parameters: - name: application-id @@ -8621,10 +8621,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: applications.application.unsetVerifiedPublisher parameters: - name: application-id @@ -30911,7 +30911,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 @@ -32243,7 +32243,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 @@ -86246,7 +86246,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 @@ -91435,7 +91435,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.ListDeletedItems parameters: - $ref: '#/components/parameters/top' @@ -91488,7 +91488,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 @@ -91901,7 +91901,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 @@ -91949,7 +91949,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 @@ -92377,7 +92377,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 @@ -94475,7 +94475,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 @@ -96318,7 +96318,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 @@ -97183,7 +97183,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 @@ -192793,7 +192793,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 @@ -292549,7 +292549,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 @@ -429490,10 +429490,6 @@ paths: tags: - me.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: me.mailFolders.mailFolder.childFolders.mailFolder.messages.message.createForward parameters: - name: mailFolder-id @@ -431684,10 +431680,6 @@ paths: tags: - me.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: me.mailFolders.mailFolder.messages.message.createForward parameters: - name: mailFolder-id @@ -436105,10 +436097,6 @@ paths: tags: - me.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: me.messages.message.createForward parameters: - name: message-id @@ -437139,7 +437127,7 @@ paths: tags: - me.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 @@ -454420,14 +454408,13 @@ paths: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation - '/me/sponsors/{directoryObject-id}': - description: Provides operations to manage the sponsors property of the microsoft.graph.user entity. - get: + '/me/sponsors/{directoryObject-id}/$ref': + description: Provides operations to manage the collection of user entities. + delete: tags: - me.directoryObject - summary: Get sponsors from me - 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: me.GetSponsors + summary: Delete ref of navigation property sponsors for me + operationId: me.sponsors.DeleteRefDirectoryObject parameters: - name: directoryObject-id in: path @@ -454436,33 +454423,14 @@ paths: schema: type: string x-ms-docs-key-type: directoryObject - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false + - name: If-Match + in: header + description: ETag schema: - uniqueItems: true - type: array - items: - type: string + type: string responses: - '200': - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.directoryObject' + '204': + description: Success default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation @@ -454481,6 +454449,75 @@ paths: $ref: '#/components/responses/ODataCountResponse' default: $ref: '#/components/responses/error' + /me/sponsors/$ref: + description: Provides operations to manage the collection of user entities. + get: + tags: + - me.directoryObject + summary: Get ref of sponsors from me + 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: me.ListRefSponsors + parameters: + - $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: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + '200': + $ref: '#/components/responses/StringCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - me.directoryObject + summary: Create new navigation property ref to sponsors for me + operationId: me.CreateRefSponsors + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - me.directoryObject + summary: Delete ref of navigation property sponsors for me + operationId: me.DeleteRefSponsors + parameters: + - name: If-Match + in: header + description: ETag + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + schema: + type: string + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation /me/teamwork: description: Provides operations to manage the teamwork property of the microsoft.graph.user entity. get: @@ -461697,7 +461734,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 @@ -462352,7 +462389,7 @@ paths: tags: - permissionGrants.resourceSpecificPermissionGrant.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 @@ -501695,7 +501732,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 @@ -502040,7 +502077,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 @@ -502093,7 +502130,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 @@ -524088,7 +524125,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 @@ -524151,7 +524188,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 @@ -524179,7 +524216,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 @@ -524226,7 +524263,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 @@ -524256,7 +524293,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 @@ -527507,7 +527544,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 @@ -617350,6 +617387,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.containers.ListColumns parameters: - name: fileStorageContainer-id @@ -617441,6 +617479,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.containers.GetColumns parameters: - name: fileStorageContainer-id @@ -620690,6 +620729,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.deletedContainers.ListColumns parameters: - name: fileStorageContainer-id @@ -620781,6 +620821,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.deletedContainers.GetColumns parameters: - name: fileStorageContainer-id @@ -718037,10 +718078,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: users.user.mailFolders.mailFolder.childFolders.mailFolder.messages.message.createForward parameters: - name: user-id @@ -720503,10 +720540,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: users.user.mailFolders.mailFolder.messages.message.createForward parameters: - name: user-id @@ -725708,10 +725741,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: users.user.messages.message.createForward parameters: - name: user-id @@ -726946,7 +726975,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 @@ -747169,14 +747198,17 @@ paths: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation - '/users/{user-id}/sponsors/{directoryObject-id}': - description: Provides operations to manage the sponsors property of the microsoft.graph.user entity. - get: + '/users/{user-id}/sponsors/{directoryObject-id}/$ref': + description: Provides operations to manage the collection of user entities. + 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: users.GetSponsors + 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: users.sponsors.DeleteRefDirectoryObject parameters: - name: user-id in: path @@ -747192,33 +747224,14 @@ paths: schema: type: string x-ms-docs-key-type: directoryObject - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false + - name: If-Match + in: header + description: ETag schema: - uniqueItems: true - type: array - items: - type: string + type: string responses: - '200': - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.directoryObject' + '204': + description: Success default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation @@ -747244,6 +747257,108 @@ paths: $ref: '#/components/responses/ODataCountResponse' default: $ref: '#/components/responses/error' + '/users/{user-id}/sponsors/$ref': + description: Provides operations to manage the collection of user entities. + 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: users.ListRefSponsors + parameters: + - name: user-id + in: path + description: The unique identifier of user + required: true + 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: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + '200': + $ref: '#/components/responses/StringCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - users.directoryObject + 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: users.CreateRefSponsors + parameters: + - name: user-id + in: path + description: The unique identifier of user + required: true + schema: + type: string + x-ms-docs-key-type: user + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + '204': + 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: users.DeleteRefSponsors + parameters: + - name: user-id + in: path + description: The unique identifier of user + required: true + schema: + type: string + x-ms-docs-key-type: user + - name: If-Match + in: header + description: ETag + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + schema: + type: string + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation '/users/{user-id}/teamwork': description: Provides operations to manage the teamwork property of the microsoft.graph.user entity. get: @@ -753811,12 +753926,12 @@ components: - $ref: '#/components/schemas/microsoft.graph.alertFeedback' - type: object nullable: true - description: 'Analyst feedback on the alert. The possible values are: unknown, truePositive, falsePositive, benignPositive. Supports update.' + description: 'Analyst feedback on the alert. The possible values are: unknown, truePositive, falsePositive, benignPositive. Updatable.' fileStates: 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: @@ -753825,7 +753940,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: @@ -753860,7 +753975,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: @@ -753871,7 +753986,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: @@ -753897,7 +754012,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. @@ -765652,6 +765767,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.columnDefinition' + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. x-ms-navigationProperty: true drive: anyOf: @@ -778604,7 +778720,7 @@ components: - $ref: '#/components/schemas/microsoft.graph.simulationStatus' - type: object nullable: true - description: 'Status of the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, draft, running, scheduled, succeeded, failed, cancelled, excluded, unknownFutureValue.' + description: 'Status of the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, draft, running, scheduled, succeeded, failed, canceled, excluded, unknownFutureValue.' trainingSetting: anyOf: - $ref: '#/components/schemas/microsoft.graph.trainingSetting' @@ -821967,7 +822083,7 @@ components: - $ref: '#/components/schemas/microsoft.graph.externalConnectors.label' - type: object nullable: true - 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 get the following values in this evolvable enum: containerName, containerUrl, iconUrl, assignedTo, dueDate, closedDate, closedBy, reportedBy, sprintName, severity, state, priority, secondaryId, itemParentId, parentUrl, tags, itemType, itemPath, numReactions.' + 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/openapi/v1.0/graphexplorer.yaml b/openapi/v1.0/graphexplorer.yaml index 4a894ed17..26b2fd149 100644 --- a/openapi/v1.0/graphexplorer.yaml +++ b/openapi/v1.0/graphexplorer.yaml @@ -8295,7 +8295,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 @@ -8503,7 +8503,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 @@ -8531,7 +8531,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 @@ -8640,7 +8640,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 @@ -8670,7 +8670,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 @@ -10241,10 +10241,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: applications.application.removeKey parameters: - name: application-id @@ -10317,7 +10317,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 @@ -10349,10 +10349,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: applications.application.setVerifiedPublisher parameters: - name: application-id @@ -10384,10 +10384,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: applications.application.unsetVerifiedPublisher parameters: - name: application-id @@ -36319,7 +36319,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 @@ -37810,7 +37810,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 @@ -102404,7 +102404,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 @@ -108232,7 +108232,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.ListDeletedItems parameters: - $ref: '#/components/parameters/top' @@ -108295,7 +108295,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 @@ -108728,7 +108728,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 @@ -108781,7 +108781,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 @@ -109249,7 +109249,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 @@ -111628,7 +111628,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 @@ -113621,7 +113621,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 @@ -114555,7 +114555,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 @@ -244509,7 +244509,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 @@ -361979,7 +361979,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 @@ -536297,10 +536297,6 @@ paths: tags: - me.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: me.mailFolders.mailFolder.childFolders.mailFolder.messages.message.createForward parameters: - name: mailFolder-id @@ -538863,10 +538859,6 @@ paths: tags: - me.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: me.mailFolders.mailFolder.messages.message.createForward parameters: - name: mailFolder-id @@ -544554,10 +544546,6 @@ paths: tags: - me.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: me.messages.message.createForward parameters: - name: message-id @@ -545715,7 +545703,7 @@ paths: tags: - me.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 @@ -566008,14 +565996,13 @@ paths: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation - '/me/sponsors/{directoryObject-id}': - description: Provides operations to manage the sponsors property of the microsoft.graph.user entity. - get: + '/me/sponsors/{directoryObject-id}/$ref': + description: Provides operations to manage the collection of user entities. + delete: tags: - me.directoryObject - summary: Get sponsors from me - 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: me.GetSponsors + summary: Delete ref of navigation property sponsors for me + operationId: me.sponsors.DeleteRefDirectoryObject parameters: - name: directoryObject-id in: path @@ -566024,9 +566011,49 @@ paths: schema: type: string x-ms-docs-key-type: directoryObject - - name: $select + - name: If-Match + in: header + description: ETag + schema: + type: string + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + /me/sponsors/$count: + description: Provides operations to count the resources in the collection. + get: + tags: + - me.directoryObject + summary: Get the number of the resource + operationId: me.sponsors.GetCount-761c + parameters: + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + '200': + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + /me/sponsors/$ref: + description: Provides operations to manage the collection of user entities. + get: + tags: + - me.directoryObject + summary: Get ref of sponsors from me + 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: me.ListRefSponsors + parameters: + - $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: Select properties to be returned + description: Order items by property values style: form explode: false schema: @@ -566035,45 +566062,55 @@ paths: items: enum: - id + - id desc - deletedDateTime - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - enum: - - '*' + - deletedDateTime desc type: string responses: '200': - 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 - /me/sponsors/$count: - description: Provides operations to count the resources in the collection. - get: + post: tags: - me.directoryObject - summary: Get the number of the resource - operationId: me.sponsors.GetCount-761c + summary: Create new navigation property ref to sponsors for me + operationId: me.CreateRefSponsors + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - me.directoryObject + summary: Delete ref of navigation property sponsors for me + operationId: me.DeleteRefSponsors parameters: - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' + - name: If-Match + in: header + description: ETag + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + schema: + type: string responses: - '200': - $ref: '#/components/responses/ODataCountResponse' + '204': + description: Success default: $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation /me/teamwork: description: Provides operations to manage the teamwork property of the microsoft.graph.user entity. get: @@ -574224,7 +574261,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 @@ -574924,7 +574961,7 @@ paths: tags: - permissionGrants.resourceSpecificPermissionGrant.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 @@ -623425,7 +623462,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 @@ -624041,7 +624078,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 @@ -624137,7 +624174,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 @@ -652666,7 +652703,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 @@ -652877,7 +652914,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 @@ -652905,7 +652942,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 @@ -653027,7 +653064,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 @@ -653057,7 +653094,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 @@ -656691,7 +656728,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 @@ -767637,6 +767674,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.containers.ListColumns parameters: - name: fileStorageContainer-id @@ -767830,6 +767868,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.containers.GetColumns parameters: - name: fileStorageContainer-id @@ -772423,6 +772462,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.deletedContainers.ListColumns parameters: - name: fileStorageContainer-id @@ -772616,6 +772656,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.deletedContainers.GetColumns parameters: - name: fileStorageContainer-id @@ -895611,10 +895652,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: users.user.mailFolders.mailFolder.childFolders.mailFolder.messages.message.createForward parameters: - name: user-id @@ -898449,10 +898486,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: users.user.mailFolders.mailFolder.messages.message.createForward parameters: - name: user-id @@ -904924,10 +904957,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: users.user.messages.message.createForward parameters: - name: user-id @@ -906289,7 +906318,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 @@ -929524,14 +929553,17 @@ paths: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation - '/users/{user-id}/sponsors/{directoryObject-id}': - description: Provides operations to manage the sponsors property of the microsoft.graph.user entity. - get: + '/users/{user-id}/sponsors/{directoryObject-id}/$ref': + description: Provides operations to manage the collection of user entities. + 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: users.GetSponsors + 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: users.sponsors.DeleteRefDirectoryObject parameters: - name: user-id in: path @@ -929547,9 +929579,66 @@ paths: schema: type: string x-ms-docs-key-type: directoryObject - - name: $select + - name: If-Match + in: header + description: ETag + schema: + type: string + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + '/users/{user-id}/sponsors/$count': + description: Provides operations to count the resources in the collection. + get: + tags: + - users.directoryObject + summary: Get the number of the resource + operationId: users.sponsors.GetCount-f3b9 + parameters: + - name: user-id + in: path + description: The unique identifier of user + required: true + schema: + type: string + x-ms-docs-key-type: user + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + responses: + '200': + $ref: '#/components/responses/ODataCountResponse' + default: + $ref: '#/components/responses/error' + '/users/{user-id}/sponsors/$ref': + description: Provides operations to manage the collection of user entities. + 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: users.ListRefSponsors + parameters: + - name: user-id + in: path + description: The unique identifier of user + required: true + 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: Select properties to be returned + description: Order items by property values style: form explode: false schema: @@ -929558,37 +929647,28 @@ paths: items: enum: - id + - id desc - deletedDateTime - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - enum: - - '*' + - deletedDateTime desc type: string responses: '200': - 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': - description: Provides operations to count the resources in the collection. - get: + post: tags: - users.directoryObject - summary: Get the number of the resource - operationId: users.sponsors.GetCount-f3b9 + 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: users.CreateRefSponsors parameters: - name: user-id in: path @@ -929597,13 +929677,48 @@ paths: schema: type: string x-ms-docs-key-type: user - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' + requestBody: + $ref: '#/components/requestBodies/refPostBody' responses: - '200': - $ref: '#/components/responses/ODataCountResponse' + '204': + 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: users.DeleteRefSponsors + parameters: + - name: user-id + in: path + description: The unique identifier of user + required: true + schema: + type: string + x-ms-docs-key-type: user + - name: If-Match + in: header + description: ETag + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + schema: + type: string + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation '/users/{user-id}/teamwork': description: Provides operations to manage the teamwork property of the microsoft.graph.user entity. get: @@ -937085,12 +937200,12 @@ components: - $ref: '#/components/schemas/microsoft.graph.alertFeedback' - type: object nullable: true - description: 'Analyst feedback on the alert. The possible values are: unknown, truePositive, falsePositive, benignPositive. Supports update.' + description: 'Analyst feedback on the alert. The possible values are: unknown, truePositive, falsePositive, benignPositive. Updatable.' fileStates: 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: @@ -937099,7 +937214,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: @@ -937134,7 +937249,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: @@ -937145,7 +937260,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: @@ -937171,7 +937286,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. @@ -948926,6 +949041,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.columnDefinition' + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. x-ms-navigationProperty: true drive: anyOf: @@ -961878,7 +961994,7 @@ components: - $ref: '#/components/schemas/microsoft.graph.simulationStatus' - type: object nullable: true - description: 'Status of the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, draft, running, scheduled, succeeded, failed, cancelled, excluded, unknownFutureValue.' + description: 'Status of the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, draft, running, scheduled, succeeded, failed, canceled, excluded, unknownFutureValue.' trainingSetting: anyOf: - $ref: '#/components/schemas/microsoft.graph.trainingSetting' @@ -1005241,7 +1005357,7 @@ components: - $ref: '#/components/schemas/microsoft.graph.externalConnectors.label' - type: object nullable: true - 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 get the following values in this evolvable enum: containerName, containerUrl, iconUrl, assignedTo, dueDate, closedDate, closedBy, reportedBy, sprintName, severity, state, priority, secondaryId, itemParentId, parentUrl, tags, itemType, itemPath, numReactions.' + 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/openapi/v1.0/openapi.yaml b/openapi/v1.0/openapi.yaml index 3ad44860a..9fd5dcd97 100644 --- a/openapi/v1.0/openapi.yaml +++ b/openapi/v1.0/openapi.yaml @@ -6835,7 +6835,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 @@ -6900,7 +6900,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 @@ -6930,7 +6930,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 @@ -6972,7 +6972,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 @@ -7000,7 +7000,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 @@ -8382,10 +8382,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: applications.application.removeKey requestBody: description: Action parameters @@ -8462,7 +8462,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 @@ -8496,10 +8496,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: applications.application.setVerifiedPublisher requestBody: description: Action parameters @@ -8533,10 +8533,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: applications.application.unsetVerifiedPublisher responses: '204': @@ -12248,7 +12248,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 @@ -12290,7 +12290,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 @@ -12318,7 +12318,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 @@ -12351,7 +12351,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 @@ -12393,7 +12393,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 @@ -12421,7 +12421,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 @@ -30235,7 +30235,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 @@ -31618,7 +31618,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 @@ -84090,7 +84090,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 @@ -89506,7 +89506,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.ListDeletedItems parameters: - $ref: '#/components/parameters/top' @@ -89561,7 +89561,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 @@ -89989,7 +89989,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 @@ -90040,7 +90040,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 @@ -90494,7 +90494,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 @@ -92616,7 +92616,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 @@ -94534,7 +94534,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 @@ -95496,7 +95496,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 @@ -256654,7 +256654,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 @@ -345181,7 +345181,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 @@ -457269,10 +457269,6 @@ paths: tags: - me.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: me.mailFolders.mailFolder.childFolders.mailFolder.messages.message.createForward requestBody: description: Action parameters @@ -459357,10 +459353,6 @@ paths: tags: - me.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: me.mailFolders.mailFolder.messages.message.createForward requestBody: description: Action parameters @@ -463756,10 +463748,6 @@ paths: tags: - me.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: me.messages.message.createForward requestBody: description: Action parameters @@ -464839,7 +464827,7 @@ paths: tags: - me.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 @@ -481710,42 +481698,22 @@ paths: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation - '/me/sponsors/{directoryObject-id}': - description: Provides operations to manage the sponsors property of the microsoft.graph.user entity. - get: + '/me/sponsors/{directoryObject-id}/$ref': + description: Provides operations to manage the collection of user entities. + delete: tags: - me.directoryObject - summary: Get sponsors from me - 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: me.GetSponsors + summary: Delete ref of navigation property sponsors for me + operationId: me.sponsors.DeleteRefDirectoryObject parameters: - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false + - name: If-Match + in: header + description: ETag schema: - uniqueItems: true - type: array - items: - type: string + type: string responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.directoryObject' + '204': + description: Success 4XX: $ref: '#/components/responses/error' 5XX: @@ -481776,6 +481744,81 @@ paths: $ref: '#/components/responses/error' 5XX: $ref: '#/components/responses/error' + /me/sponsors/$ref: + description: Provides operations to manage the collection of user entities. + get: + tags: + - me.directoryObject + summary: Get ref of sponsors from me + 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: me.ListRefSponsors + parameters: + - $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: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/StringCollectionResponse' + 4XX: + $ref: '#/components/responses/error' + 5XX: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - me.directoryObject + summary: Create new navigation property ref to sponsors for me + operationId: me.CreateRefSponsors + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + '204': + description: Success + 4XX: + $ref: '#/components/responses/error' + 5XX: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - me.directoryObject + summary: Delete ref of navigation property sponsors for me + operationId: me.DeleteRefSponsors + parameters: + - name: If-Match + in: header + description: ETag + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + schema: + type: string + responses: + '204': + description: Success + 4XX: + $ref: '#/components/responses/error' + 5XX: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation /me/teamwork: description: Provides operations to manage the teamwork property of the microsoft.graph.user entity. get: @@ -488520,7 +488563,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 @@ -489197,7 +489240,7 @@ paths: tags: - permissionGrants.resourceSpecificPermissionGrant.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 @@ -528349,7 +528392,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 @@ -528712,7 +528755,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 @@ -528760,7 +528803,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 @@ -550857,7 +550900,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 @@ -550922,7 +550965,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 @@ -550952,7 +550995,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 @@ -550994,7 +551037,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 @@ -551022,7 +551065,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 @@ -554253,7 +554296,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 @@ -559975,7 +560018,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 @@ -560017,7 +560060,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 @@ -560045,7 +560088,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 @@ -635697,6 +635740,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.containers.ListColumns parameters: - $ref: '#/components/parameters/top' @@ -635785,6 +635829,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.containers.GetColumns parameters: - name: $select @@ -638956,6 +639001,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.deletedContainers.ListColumns parameters: - $ref: '#/components/parameters/top' @@ -639044,6 +639090,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.deletedContainers.GetColumns parameters: - name: $select @@ -707285,10 +707332,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: users.user.mailFolders.mailFolder.childFolders.mailFolder.messages.message.createForward requestBody: description: Action parameters @@ -709554,10 +709597,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: users.user.mailFolders.mailFolder.messages.message.createForward requestBody: description: Action parameters @@ -714519,10 +714558,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: users.user.messages.message.createForward requestBody: description: Action parameters @@ -715811,7 +715846,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 @@ -734478,42 +734513,26 @@ paths: schema: type: string x-ms-docs-key-type: user - '/users/{user-id}/sponsors/{directoryObject-id}': - description: Provides operations to manage the sponsors property of the microsoft.graph.user entity. - get: + '/users/{user-id}/sponsors/{directoryObject-id}/$ref': + description: Provides operations to manage the collection of user entities. + 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: users.GetSponsors + 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: users.sponsors.DeleteRefDirectoryObject parameters: - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false + - name: If-Match + in: header + description: ETag schema: - uniqueItems: true - type: array - items: - type: string + type: string responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.directoryObject' + '204': + description: Success 4XX: $ref: '#/components/responses/error' 5XX: @@ -734559,6 +734578,100 @@ paths: schema: type: string x-ms-docs-key-type: user + '/users/{user-id}/sponsors/$ref': + description: Provides operations to manage the collection of user entities. + 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: users.ListRefSponsors + parameters: + - $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: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/StringCollectionResponse' + 4XX: + $ref: '#/components/responses/error' + 5XX: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - users.directoryObject + 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: users.CreateRefSponsors + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + '204': + description: Success + 4XX: + $ref: '#/components/responses/error' + 5XX: + $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: users.DeleteRefSponsors + parameters: + - name: If-Match + in: header + description: ETag + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + schema: + type: string + responses: + '204': + description: Success + 4XX: + $ref: '#/components/responses/error' + 5XX: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + parameters: + - name: user-id + in: path + description: The unique identifier of user + required: true + schema: + type: string + x-ms-docs-key-type: user '/users/{user-id}/teamwork': description: Provides operations to manage the teamwork property of the microsoft.graph.user entity. get: @@ -740961,12 +741074,12 @@ components: - $ref: '#/components/schemas/microsoft.graph.alertFeedback' - type: object nullable: true - description: 'Analyst feedback on the alert. The possible values are: unknown, truePositive, falsePositive, benignPositive. Supports update.' + description: 'Analyst feedback on the alert. The possible values are: unknown, truePositive, falsePositive, benignPositive. Updatable.' fileStates: 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: @@ -740975,7 +741088,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: @@ -741010,7 +741123,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: @@ -741021,7 +741134,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: @@ -741047,7 +741160,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. @@ -755781,6 +755894,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.columnDefinition' + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. x-ms-navigationProperty: true drive: anyOf: @@ -770991,7 +771105,7 @@ components: - $ref: '#/components/schemas/microsoft.graph.simulationStatus' - type: object nullable: true - description: 'Status of the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, draft, running, scheduled, succeeded, failed, cancelled, excluded, unknownFutureValue.' + description: 'Status of the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, draft, running, scheduled, succeeded, failed, canceled, excluded, unknownFutureValue.' trainingSetting: anyOf: - $ref: '#/components/schemas/microsoft.graph.trainingSetting' @@ -821582,7 +821696,7 @@ components: - $ref: '#/components/schemas/microsoft.graph.externalConnectors.label' - type: object nullable: true - 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 get the following values in this evolvable enum: containerName, containerUrl, iconUrl, assignedTo, dueDate, closedDate, closedBy, reportedBy, sprintName, severity, state, priority, secondaryId, itemParentId, parentUrl, tags, itemType, itemPath, numReactions.' + 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/openapi/v1.0/powershell_v2.yaml b/openapi/v1.0/powershell_v2.yaml index 484987fb9..74274cbcd 100644 --- a/openapi/v1.0/powershell_v2.yaml +++ b/openapi/v1.0/powershell_v2.yaml @@ -7059,7 +7059,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 @@ -7122,7 +7122,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 @@ -7150,7 +7150,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 @@ -7197,7 +7197,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 @@ -7231,7 +7231,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 @@ -8658,10 +8658,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: applications.application.removeKey parameters: - name: application-id @@ -8734,7 +8734,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 @@ -8766,10 +8766,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: applications.application.setVerifiedPublisher parameters: - name: application-id @@ -8801,10 +8801,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: applications.application.unsetVerifiedPublisher parameters: - name: application-id @@ -12663,7 +12663,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 @@ -12710,7 +12710,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 @@ -12744,7 +12744,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 @@ -12774,7 +12774,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 @@ -12821,7 +12821,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 @@ -12855,7 +12855,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 @@ -31619,7 +31619,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 @@ -32962,7 +32962,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 @@ -87804,7 +87804,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 @@ -93138,7 +93138,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.ListDeletedItems parameters: - $ref: '#/components/parameters/top' @@ -93191,7 +93191,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 @@ -93604,7 +93604,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 @@ -93652,7 +93652,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 @@ -94080,7 +94080,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 @@ -96214,7 +96214,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 @@ -98064,7 +98064,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 @@ -99043,7 +99043,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 @@ -195998,7 +195998,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 @@ -296765,7 +296765,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 @@ -435474,10 +435474,6 @@ paths: tags: - me.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: me.mailFolders.mailFolder.childFolders.mailFolder.messages.message.createForward parameters: - name: mailFolder-id @@ -437686,10 +437682,6 @@ paths: tags: - me.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: me.mailFolders.mailFolder.messages.message.createForward parameters: - name: mailFolder-id @@ -442149,10 +442141,6 @@ paths: tags: - me.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: me.messages.message.createForward parameters: - name: message-id @@ -443186,7 +443174,7 @@ paths: tags: - me.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 @@ -460737,14 +460725,13 @@ paths: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation - '/me/sponsors/{directoryObject-id}': - description: Provides operations to manage the sponsors property of the microsoft.graph.user entity. - get: + '/me/sponsors/{directoryObject-id}/$ref': + description: Provides operations to manage the collection of user entities. + delete: tags: - me.directoryObject - summary: Get sponsors from me - 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: me.GetSponsors + summary: Delete ref of navigation property sponsors for me + operationId: me.sponsors.DeleteRefDirectoryObject parameters: - name: directoryObject-id in: path @@ -460753,33 +460740,14 @@ paths: schema: type: string x-ms-docs-key-type: directoryObject - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false + - name: If-Match + in: header + description: ETag schema: - uniqueItems: true - type: array - items: - type: string + type: string responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.directoryObject' + '204': + description: Success default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation @@ -460798,6 +460766,75 @@ paths: $ref: '#/components/responses/ODataCountResponse' default: $ref: '#/components/responses/error' + /me/sponsors/$ref: + description: Provides operations to manage the collection of user entities. + get: + tags: + - me.directoryObject + summary: Get ref of sponsors from me + 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: me.ListRefSponsors + parameters: + - $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: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/StringCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - me.directoryObject + summary: Create new navigation property ref to sponsors for me + operationId: me.CreateRefSponsors + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation + delete: + tags: + - me.directoryObject + summary: Delete ref of navigation property sponsors for me + operationId: me.DeleteRefSponsors + parameters: + - name: If-Match + in: header + description: ETag + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + schema: + type: string + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation /me/teamwork: description: Provides operations to manage the teamwork property of the microsoft.graph.user entity. get: @@ -468091,7 +468128,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 @@ -468753,7 +468790,7 @@ paths: tags: - permissionGrants.resourceSpecificPermissionGrant.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 @@ -508699,7 +508736,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 @@ -509054,7 +509091,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 @@ -509107,7 +509144,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 @@ -531432,7 +531469,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 @@ -531495,7 +531532,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 @@ -531523,7 +531560,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 @@ -531570,7 +531607,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 @@ -531604,7 +531641,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 @@ -534879,7 +534916,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 @@ -540679,7 +540716,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 @@ -540726,7 +540763,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 @@ -540760,7 +540797,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 @@ -625816,6 +625853,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.containers.ListColumns parameters: - name: fileStorageContainer-id @@ -625907,6 +625945,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.containers.GetColumns parameters: - name: fileStorageContainer-id @@ -629212,6 +629251,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.deletedContainers.ListColumns parameters: - name: fileStorageContainer-id @@ -629303,6 +629343,7 @@ paths: tags: - storage.fileStorage summary: Get columns from storage + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. operationId: storage.fileStorage.deletedContainers.GetColumns parameters: - name: fileStorageContainer-id @@ -727762,10 +727803,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: users.user.mailFolders.mailFolder.childFolders.mailFolder.messages.message.createForward parameters: - name: user-id @@ -730246,10 +730283,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: users.user.mailFolders.mailFolder.messages.message.createForward parameters: - name: user-id @@ -735493,10 +735526,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: users.user.messages.message.createForward parameters: - name: user-id @@ -736734,7 +736763,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 @@ -757227,14 +757256,17 @@ paths: nextLinkName: '@odata.nextLink' operationName: listMore x-ms-docs-operation-type: operation - '/users/{user-id}/sponsors/{directoryObject-id}': - description: Provides operations to manage the sponsors property of the microsoft.graph.user entity. - get: + '/users/{user-id}/sponsors/{directoryObject-id}/$ref': + description: Provides operations to manage the collection of user entities. + 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: users.GetSponsors + 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: users.sponsors.DeleteRefDirectoryObject parameters: - name: user-id in: path @@ -757250,33 +757282,14 @@ paths: schema: type: string x-ms-docs-key-type: directoryObject - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $expand - in: query - description: Expand related entities - style: form - explode: false + - name: If-Match + in: header + description: ETag schema: - uniqueItems: true - type: array - items: - type: string + type: string responses: - 2XX: - description: Retrieved navigation property - content: - application/json: - schema: - $ref: '#/components/schemas/microsoft.graph.directoryObject' + '204': + description: Success default: $ref: '#/components/responses/error' x-ms-docs-operation-type: operation @@ -757302,6 +757315,108 @@ paths: $ref: '#/components/responses/ODataCountResponse' default: $ref: '#/components/responses/error' + '/users/{user-id}/sponsors/$ref': + description: Provides operations to manage the collection of user entities. + 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: users.ListRefSponsors + parameters: + - name: user-id + in: path + description: The unique identifier of user + required: true + 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: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + responses: + 2XX: + $ref: '#/components/responses/StringCollectionResponse' + default: + $ref: '#/components/responses/error' + x-ms-pageable: + nextLinkName: '@odata.nextLink' + operationName: listMore + x-ms-docs-operation-type: operation + post: + tags: + - users.directoryObject + 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: users.CreateRefSponsors + parameters: + - name: user-id + in: path + description: The unique identifier of user + required: true + schema: + type: string + x-ms-docs-key-type: user + requestBody: + $ref: '#/components/requestBodies/refPostBody' + responses: + '204': + 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: users.DeleteRefSponsors + parameters: + - name: user-id + in: path + description: The unique identifier of user + required: true + schema: + type: string + x-ms-docs-key-type: user + - name: If-Match + in: header + description: ETag + schema: + type: string + - name: '@id' + in: query + description: The delete Uri + required: true + schema: + type: string + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + x-ms-docs-operation-type: operation '/users/{user-id}/teamwork': description: Provides operations to manage the teamwork property of the microsoft.graph.user entity. get: @@ -763959,12 +764074,12 @@ components: - $ref: '#/components/schemas/microsoft.graph.alertFeedback' - type: object nullable: true - description: 'Analyst feedback on the alert. The possible values are: unknown, truePositive, falsePositive, benignPositive. Supports update.' + description: 'Analyst feedback on the alert. The possible values are: unknown, truePositive, falsePositive, benignPositive. Updatable.' fileStates: 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: @@ -763973,7 +764088,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: @@ -764008,7 +764123,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: @@ -764019,7 +764134,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: @@ -764045,7 +764160,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. @@ -775800,6 +775915,7 @@ components: type: array items: $ref: '#/components/schemas/microsoft.graph.columnDefinition' + description: The set of custom structured metadata supported by the fileStorageContainer. Read-write. x-ms-navigationProperty: true drive: anyOf: @@ -788752,7 +788868,7 @@ components: - $ref: '#/components/schemas/microsoft.graph.simulationStatus' - type: object nullable: true - description: 'Status of the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, draft, running, scheduled, succeeded, failed, cancelled, excluded, unknownFutureValue.' + description: 'Status of the attack simulation and training campaign. Supports $filter and $orderby. The possible values are: unknown, draft, running, scheduled, succeeded, failed, canceled, excluded, unknownFutureValue.' trainingSetting: anyOf: - $ref: '#/components/schemas/microsoft.graph.trainingSetting' @@ -832115,7 +832231,7 @@ components: - $ref: '#/components/schemas/microsoft.graph.externalConnectors.label' - type: object nullable: true - 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 get the following values in this evolvable enum: containerName, containerUrl, iconUrl, assignedTo, dueDate, closedDate, closedBy, reportedBy, sprintName, severity, state, priority, secondaryId, itemParentId, parentUrl, tags, itemType, itemPath, numReactions.' + 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.'