Skip to content

Enhance restorepoint-search documentation with query examples#9788

Merged
Danipocket merged 4 commits intomicrosoftgraph:mainfrom
Subham-RKB:patch-4
Feb 9, 2026
Merged

Enhance restorepoint-search documentation with query examples#9788
Danipocket merged 4 commits intomicrosoftgraph:mainfrom
Subham-RKB:patch-4

Conversation

@Subham-RKB
Copy link
Contributor

Added artifactQuery properties and examples for filtering restore points based on multiple criteria. Updated the queryExpression in the JSON example to remove unnecessary conditions.

Important

Required for API changes:


Add other supporting information, such as a description of the PR changes:

ADD INFORMATION HERE


Important

The following guidance is for Microsoft employees only. Community contributors can ignore this message; our content team will manage the status.

After you've created your PR, expand this section for tips and additional instructions.
  • do not merge is the default PR status and is automatically added to all open PRs that don't have the ready to merge label.
  • Add the ready for content review label to start a review. Only PRs that have met the minimum requirements for content review and have this label are reviewed.
  • If your content reviewer requests changes, review the feedback and address accordingly as soon as possible to keep your pull request moving forward. After you address the feedback, remove the changes requested label, add the review feedback addressed label, and select the Re-request review icon next to the content reviewer's alias. If you can't add labels, add a comment with #feedback-addressed to the pull request.
  • After the content review is complete, your reviewer will add the content review complete label. When the updates in this PR are ready for external customers to use, replace the do not merge label with ready to merge and the PR will be merged within 24 working hours.
  • Pull requests that are inactive for more than 6 weeks will be automatically closed. Before that, you receive reminders at 2 weeks, 4 weeks, and 6 weeks. If you still need the PR, you can reopen or recreate the request.

For more information, see the Content review process summary.

Added artifactQuery properties and examples for filtering restore points based on multiple criteria. Updated the queryExpression in the JSON example to remove unnecessary conditions.
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 95198ee:

✅ Validation status: passed

File Status Preview URL Details
api-reference/beta/api/restorepoint-search.md ✅Succeeded

For more details, please refer to the build report.

@Subham-RKB Subham-RKB added the ready for content review PR is ready for a content review - content development and tech review are complete. label Feb 2, 2026
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit a3fcfd3:

✅ Validation status: passed

File Status Preview URL Details
api-reference/beta/api/restorepoint-search.md ✅Succeeded

For more details, please refer to the build report.

|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
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In my previous comments (on the old PR), I mentioned that you’re using invalid headers.

We have predefined headers—for example, Properties and Examples—and the ones you’re adding aren’t supported. Please create a concept topic instead, or move the content into standard request or response sections without headers.

I’d recommend creating a concept topic, since this is a large amount of content to include in a request or response. Here are the guidelines: (https://eng.ms/docs/products/microsoft-graph-service/microsoft-graph/document-apis/conceptual-content).

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Danipocket Thanks for the suggestions.
I have added the detail in the already existing concept topic artifactQuery.

Link to that PR: #9789

Copy link
Contributor

@Danipocket Danipocket left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Subham-RKB, please see my comments.

@Danipocket Danipocket added changes requested content review in progress and removed ready for content review PR is ready for a content review - content development and tech review are complete. labels Feb 2, 2026
Removed detailed artifactQuery properties and examples related to filtering restore points.
@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit db8551d:

✅ Validation status: passed

File Status Preview URL Details
api-reference/beta/api/restorepoint-search.md ✅Succeeded

For more details, please refer to the build report.

@learn-build-service-prod
Copy link
Contributor

Learn Build status updates of commit 26aa520:

✅ Validation status: passed

File Status Preview URL Details
api-reference/beta/api/restorepoint-search.md ✅Succeeded

For more details, please refer to the build report.

Copy link
Contributor

@Danipocket Danipocket left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

PR approved.

@Danipocket Danipocket added content review complete Apply when the content review is complete on a PR. ready to merge Use this label to indicate to the repository admins that your PR is ready to merge into master. and removed content review in progress labels Feb 5, 2026
@Danipocket Danipocket merged commit 8d82fc9 into microsoftgraph:main Feb 9, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content review complete Apply when the content review is complete on a PR. ready to merge Use this label to indicate to the repository admins that your PR is ready to merge into master.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants