From 95198ee6d72335137370624c2bec48ff2c46eb8d Mon Sep 17 00:00:00 2001 From: "Ch@ps" <61343268+Subham-RKB@users.noreply.github.com> Date: Mon, 2 Feb 2026 11:54:00 +0530 Subject: [PATCH 1/4] Enhance restorepoint-search documentation with query examples Added artifactQuery properties and examples for filtering restore points based on multiple criteria. Updated the queryExpression in the JSON example to remove unnecessary conditions. --- api-reference/beta/api/restorepoint-search.md | 51 ++++++++++++++++++- 1 file changed, 49 insertions(+), 2 deletions(-) diff --git a/api-reference/beta/api/restorepoint-search.md b/api-reference/beta/api/restorepoint-search.md index 0f4ff107d73..58108d51dea 100644 --- a/api-reference/beta/api/restorepoint-search.md +++ b/api-reference/beta/api/restorepoint-search.md @@ -55,6 +55,52 @@ In the request body, supply a JSON representation of the following parameters. |restorePointPreference|[restorePointPreference](../api/restorepoint-search.md#restorepointpreference-values)|Indicates which restore point to return. The possible values are `oldest`, `latest`. Optional.| |tags|[restorePointTags](../resources/restorepoint.md#restorepointtags-values)|The type of the restore point. The possible values are `None`, `FastRestore`, `UnknownFutureValue`. Optional.| +### artifactQuery properties + +The `queryExpression` property of the [artifactQuery](../resources/artifactquery.md) supports filtering restore points based on multiple criteria. You can combine multiple properties using logical operators to create complex search expressions. + +The following table describes all supported properties for granular search queries. + +| Property | Description | Value Type | Supported Operators | Wildcard Support | +|----------|-------------|------------|---------------------|------------------| +| Subject | The subject of the message or primary searchable string for other item types | String | -like, -and (up to 3) | * (after string) | +| Sender | Messages from the specified sender | Display name, Alias, SMTP address, or LegacyDN | -like | * (after string) | +| Participants | Messages with specified recipient in To, Bcc, or Cc fields | Display name, Alias, SMTP address, or LegacyDN | -like, -and (up to 3) | * (after string) | +| HasAttachment | Whether the message has an attachment | Boolean (true or false) | -eq | No | +| MessageKind | The mailbox item type for which to search | Enum: Email, Note, Task, Contact, Calendar | -eq | No | + +#### Query expression examples + +Search for emails from a specific sender with attachments + +``` +(Sender -like 'abc@contoso.com') -and (HasAttachment -eq 'true') +``` + +Search for emails with specific subject keywords and multiple participants + +``` +(Subject -like 'Project Alpha*') -and (Participants -like 'john@contoso.com' -and Participants -like 'sarah@contoso.com') +``` + +Search for calendar events organized by a specific user + +``` +(MessageKind -eq 'Calendar') -and (Sender -like 'admin@contoso.com') +``` + +Search for contacts by name pattern + +``` +(MessageKind -eq 'Contact') -and (Subject -like 'Smith*') +``` + +Search for emails combining multiple criteria including message type, subject, sender, and attachments + +``` +(MessageKind -eq 'Email') -and (Subject -like 'Invoice*') -and (Sender -like 'vendor*') -and (HasAttachment -eq 'true') +``` + ### restorePointPreference values |Member | Description | @@ -217,12 +263,13 @@ Content-Type: application/json { "artifactQuery": { - "queryExpression": "(Sender -like 'abc@contoso.com') -and (Subject -like '*Check email*' -or Subject -like ' Important') -and (HasAttachment -eq 'true') -and (PitrDumpsterActionTriggeredTime -gt '2024-09-21T08:20:00.0000000Z')", + "queryExpression": "(Sender -like 'abc@contoso.com') -and (Subject -like '*Check email*' -or Subject -like ' Important') -and (HasAttachment -eq 'true')", "artifactType": "message" }, "protectionUnitIds": ["23014d8c-71fe-4d00-a01a-31850bc5b42a"], "protectionTimePeriod": { - "startDateTime": "2021-01-01T00:00:00Z" + "startDateTime": "2021-01-01T00:00:00Z", + "endDateTime": "2021-01-30T00:00:00Z" }, "restorePointPreference": "oldest" } From a3fcfd30976032f3d5c6bab2d242635a143bf052 Mon Sep 17 00:00:00 2001 From: Danipocket <88507770+Danipocket@users.noreply.github.com> Date: Mon, 2 Feb 2026 10:37:56 -0600 Subject: [PATCH 2/4] Update restorepoint-search.md --- api-reference/beta/api/restorepoint-search.md | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/beta/api/restorepoint-search.md b/api-reference/beta/api/restorepoint-search.md index 58108d51dea..8a1e03a20c1 100644 --- a/api-reference/beta/api/restorepoint-search.md +++ b/api-reference/beta/api/restorepoint-search.md @@ -342,3 +342,4 @@ Content-Type: application/json ] } ``` + From db8551d758446efa0cdae15196f0ce3ed34ae011 Mon Sep 17 00:00:00 2001 From: "Ch@ps" <61343268+Subham-RKB@users.noreply.github.com> Date: Tue, 3 Feb 2026 13:01:00 +0530 Subject: [PATCH 3/4] Remove artifactQuery properties and examples Removed detailed artifactQuery properties and examples related to filtering restore points. --- api-reference/beta/api/restorepoint-search.md | 46 ------------------- 1 file changed, 46 deletions(-) diff --git a/api-reference/beta/api/restorepoint-search.md b/api-reference/beta/api/restorepoint-search.md index 8a1e03a20c1..073a6fa253a 100644 --- a/api-reference/beta/api/restorepoint-search.md +++ b/api-reference/beta/api/restorepoint-search.md @@ -55,52 +55,6 @@ In the request body, supply a JSON representation of the following parameters. |restorePointPreference|[restorePointPreference](../api/restorepoint-search.md#restorepointpreference-values)|Indicates which restore point to return. The possible values are `oldest`, `latest`. Optional.| |tags|[restorePointTags](../resources/restorepoint.md#restorepointtags-values)|The type of the restore point. The possible values are `None`, `FastRestore`, `UnknownFutureValue`. Optional.| -### artifactQuery properties - -The `queryExpression` property of the [artifactQuery](../resources/artifactquery.md) supports filtering restore points based on multiple criteria. You can combine multiple properties using logical operators to create complex search expressions. - -The following table describes all supported properties for granular search queries. - -| Property | Description | Value Type | Supported Operators | Wildcard Support | -|----------|-------------|------------|---------------------|------------------| -| Subject | The subject of the message or primary searchable string for other item types | String | -like, -and (up to 3) | * (after string) | -| Sender | Messages from the specified sender | Display name, Alias, SMTP address, or LegacyDN | -like | * (after string) | -| Participants | Messages with specified recipient in To, Bcc, or Cc fields | Display name, Alias, SMTP address, or LegacyDN | -like, -and (up to 3) | * (after string) | -| HasAttachment | Whether the message has an attachment | Boolean (true or false) | -eq | No | -| MessageKind | The mailbox item type for which to search | Enum: Email, Note, Task, Contact, Calendar | -eq | No | - -#### Query expression examples - -Search for emails from a specific sender with attachments - -``` -(Sender -like 'abc@contoso.com') -and (HasAttachment -eq 'true') -``` - -Search for emails with specific subject keywords and multiple participants - -``` -(Subject -like 'Project Alpha*') -and (Participants -like 'john@contoso.com' -and Participants -like 'sarah@contoso.com') -``` - -Search for calendar events organized by a specific user - -``` -(MessageKind -eq 'Calendar') -and (Sender -like 'admin@contoso.com') -``` - -Search for contacts by name pattern - -``` -(MessageKind -eq 'Contact') -and (Subject -like 'Smith*') -``` - -Search for emails combining multiple criteria including message type, subject, sender, and attachments - -``` -(MessageKind -eq 'Email') -and (Subject -like 'Invoice*') -and (Sender -like 'vendor*') -and (HasAttachment -eq 'true') -``` - ### restorePointPreference values |Member | Description | From 26aa52070b5cf0c8dddcc3a5a2f1a70954f256bf Mon Sep 17 00:00:00 2001 From: "Ch@ps" <61343268+Subham-RKB@users.noreply.github.com> Date: Tue, 3 Feb 2026 13:02:09 +0530 Subject: [PATCH 4/4] Fix formatting by adding missing newline at end of file --- api-reference/beta/api/restorepoint-search.md | 1 - 1 file changed, 1 deletion(-) diff --git a/api-reference/beta/api/restorepoint-search.md b/api-reference/beta/api/restorepoint-search.md index 073a6fa253a..a7c3408d32b 100644 --- a/api-reference/beta/api/restorepoint-search.md +++ b/api-reference/beta/api/restorepoint-search.md @@ -296,4 +296,3 @@ Content-Type: application/json ] } ``` -