{"id":9481,"date":"2022-02-02T18:28:45","date_gmt":"2022-02-03T02:28:45","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=9481"},"modified":"2022-10-12T16:12:40","modified_gmt":"2022-10-12T23:12:40","slug":"breaking-changes-to-the-microsoft-graph-api-for-ediscovery-beta","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/breaking-changes-to-the-microsoft-graph-api-for-ediscovery-beta\/","title":{"rendered":"Breaking changes to the Microsoft Graph API for eDiscovery (beta)"},"content":{"rendered":"<p><span data-contrast=\"none\">Today, we\u2019re announcing some upcoming breaking changes for developers using the Microsoft Graph API for eDiscovery. The eDiscovery API enables an organization\u2019s compliance officers to respond to data requests for litigation, investigations, and other legal requests. We&#8217;re changing the way that holds are applied to custodians so that we can more efficiently batch policy application. As a result, we are removing the <\/span><b><span data-contrast=\"none\">applyHoldToSources <\/span><\/b><span data-contrast=\"none\">property from the custodian and non-custodial data resources and adding an <\/span><b><span data-contrast=\"none\">applyHold <\/span><\/b><span data-contrast=\"none\">method to individual custodians and non-custodial data sources as well as their respective collections. This change will be staged so <\/span><b><span data-contrast=\"none\">applyHoldToSources<\/span><\/b><span data-contrast=\"none\"> will be removed 2-3 weeks after <code>\/appyHold<\/code> is introduced to give you time to switch to the new model.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:240}\">\u00a0<\/span><\/p>\n<p><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:240}\">\u00a0<\/span><span data-contrast=\"none\">When <code>\/applyHold<\/code> is called, an operation is created to monitor the progress of the hold. This new operation requires us to update the <\/span><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/resources\/ediscovery-caseoperation?view=graph-rest-beta#caseaction-values\"><span data-contrast=\"none\">caseOperation<\/span><\/a><span data-contrast=\"auto\"> enum. We are inserting a new operation before the <\/span><b><span data-contrast=\"auto\">unknowFutureValue <\/span><\/b><span data-contrast=\"auto\">with the new operation. For more information about <\/span><b><span data-contrast=\"auto\">unknownFutureValues <\/span><\/b><span data-contrast=\"auto\">in Microsoft Graph enums, see <\/span><a href=\"https:\/\/docs.microsoft.com\/graph\/best-practices-concept?context=graph%2Fapi%2F1.0&amp;view=graph-rest-1.0#handling-future-members-in-evolvable-enumerations\"><span data-contrast=\"none\">Best practices for working with Microsoft Graph<\/span><\/a><span data-contrast=\"auto\">.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:240}\">\u00a0<\/span><\/p>\n<p><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:240}\">\u00a0<\/span><span data-contrast=\"none\">This change will go into effect on February 16, 2022.<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:240}\">\u00a0<\/span><\/p>\n<p><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:240}\">\u00a0<\/span><span data-contrast=\"none\">To learn more about applying holds to custodians and non-custodial data sources, see:<\/span><span data-ccp-props=\"{&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:240}\">\u00a0<\/span><\/p>\n<ul>\n<li><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/resources\/ediscovery-custodian?view=graph-rest-beta\"><span data-contrast=\"none\">custodian resource type &#8211; Microsoft Graph beta | Microsoft Docs<\/span><\/a><span data-ccp-props=\"{&quot;134233279&quot;:true,&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:240}\">\u00a0<\/span><\/li>\n<li><a href=\"https:\/\/docs.microsoft.com\/graph\/api\/resources\/ediscovery-noncustodialdatasource?view=graph-rest-beta\"><span data-contrast=\"none\">noncustodialDataSource resource type &#8211; Microsoft Graph beta | Microsoft Docs<\/span><\/a><span data-ccp-props=\"{&quot;134233279&quot;:true,&quot;201341983&quot;:0,&quot;335559739&quot;:160,&quot;335559740&quot;:240}\">\u00a0<\/span><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Today, we\u2019re announcing some upcoming breaking changes for developers using the Microsoft Graph API for eDiscovery. We&#8217;re changing the way that holds are applied to custodians so that we can more efficiently batch policy application.<\/p>\n","protected":false},"author":69077,"featured_media":160,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3],"tags":[203,202],"class_list":["post-9481","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","tag-ediscovery","tag-security"],"acf":[],"blog_post_summary":"<p>Today, we\u2019re announcing some upcoming breaking changes for developers using the Microsoft Graph API for eDiscovery. We&#8217;re changing the way that holds are applied to custodians so that we can more efficiently batch policy application.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/9481","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69077"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=9481"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/9481\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/160"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=9481"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=9481"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=9481"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}