Skip to content

Added Documentation Page for Bulk Container Permission Creation via D…#9873

Closed
RushwantKoppolu wants to merge 2 commits intomicrosoftgraph:mainfrom
RushwantKoppolu:user/rkoppolu/GraphDocumentationDeltaPatchCreatePermission
Closed

Added Documentation Page for Bulk Container Permission Creation via D…#9873
RushwantKoppolu wants to merge 2 commits intomicrosoftgraph:mainfrom
RushwantKoppolu:user/rkoppolu/GraphDocumentationDeltaPatchCreatePermission

Conversation

@RushwantKoppolu
Copy link
Copy Markdown

…elta Patch

Important

Required for API changes:

  • [] Link to API.md file: N/A (no new API introduced; documentation for existing Delta
  • [] Link to PR for public-facing schema changes (schema-Prod-beta/v1.0.csdl): N/A (no schema changes)
  • [] Attach the documentation plan generated for AI-assisted docs authoring and validation to help speed up content review.

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

This PR introduces a new API documentation page for bulk permission creation using Delta Patch on fileStorageContainer resources in Microsoft Graph.

It documents:
Adding up to 10 permissions in a single request
Delta Patch request structure (PATCH + value[])
Partial success behavior for batch operations

This PR does not modify existing Create (POST) or Update (PATCH) permission documentation.


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.

@RushwantKoppolu RushwantKoppolu marked this pull request as draft April 23, 2026 17:11
@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit 074a7d0:

⚠️ Validation status: warnings

File Status Preview URL Details
api-reference/beta/api/filestoragecontainer-deltapatch-permissions.md ⚠️Warning Details
api-reference/beta/includes/permissions/filestoragecontainer-deltapatch-permissions-permissions.md ✅Succeeded
api-reference/beta/resources/filestoragecontainer.md ✅Succeeded

api-reference/beta/api/filestoragecontainer-deltapatch-permissions.md

  • Line 4, Column 9: [Warning: author-not-found - See documentation] Invalid value for author: 'rkoppolu' is not a valid GitHub ID.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

Comment thread api-reference/beta/api/filestoragecontainer-deltapatch-permissions.md Outdated
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Isn't this supposed to be auto-generated?

|[Get drive](../api/filestoragecontainer-get-drive.md)|[drive](../resources/drive.md)|Get the drive resource from a [fileStorageContainer](../resources/filestoragecontainer.md) object.|
|[List permissions](../api/filestoragecontainer-list-permissions.md)|[permission](../resources/permission.md) collection| List permissions on a fileStorageContainer.|
|[Add permissions](../api/filestoragecontainer-post-permissions.md)|[permission](../resources/permission.md)|Add permission to a fileStorageContainer.|
|[Create permissions in bulk](../api/filestoragecontainer-deltapatch-permissions.md)|[permission](../resources/permission.md) collection|Add multiple permissions to a fileStorageContainer using delta patch.|
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Delta patch permissions

@@ -0,0 +1,196 @@
---
title: "Create permissions in bulk"
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

We will review beta first, after that, we can add the v1.0 doc in this same PR.

@vhontovyy-MS vhontovyy-MS self-requested a review April 23, 2026 17:58
@RushwantKoppolu
Copy link
Copy Markdown
Author

@RushwantKoppolu please read the following Contributor License Agreement(CLA). If you agree with the CLA, please reply with the following information.

@microsoft-github-policy-service agree [company="{your company}"]

Options:

  • (default - no company specified) I have sole ownership of intellectual property rights to my Submissions and I am not making Submissions in the course of work for my employer.
@microsoft-github-policy-service agree
  • (when company given) I am making Submissions in the course of work for my employer (or my employer has intellectual property rights in my Submissions by contract or applicable law). I have permission from my employer to make Submissions and enter into this Agreement on behalf of my employer. By signing below, the defined term “You” includes me and my employer.
@microsoft-github-policy-service agree company="Microsoft"

Contributor License Agreement

@microsoft-github-policy-service agree company="Microsoft"

@learn-build-service-prod
Copy link
Copy Markdown
Contributor

Learn Build status updates of commit fbc2164:

✅ Validation status: passed

File Status Preview URL Details
api-reference/beta/api/filestoragecontainer-deltapatch-permissions.md ✅Succeeded
api-reference/beta/includes/permissions/filestoragecontainer-deltapatch-permissions-permissions.md ✅Succeeded
api-reference/beta/resources/filestoragecontainer.md ✅Succeeded

For more details, please refer to the build report.


> [!NOTE]
> Currently, we only support bulk **creating** permissions. Bulk updating and deleting permissions will be supported in the future.
> [!IMPORTANT]
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Image Important is not showing correctly

|Name|Type|Description|
|:---|:---|:---|
|@context|String|Must be set to `#$delta` to signal a delta patch operation. Required.|
|value|[permission](../resources/permission.md) collection|A collection of up to 10 permission objects to process. Required.|
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Collection(permission) like the roles?

FaithOmbongi

This comment was marked as outdated.

Copy link
Copy Markdown
Contributor

@FaithOmbongi FaithOmbongi left a comment

Choose a reason for hiding this comment

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

@RushwantKoppolu - We don't accept contributions for schema-related changes through the public repo. Please move these changes to the private repo instead. See https://aka.ms/msgraphcdk for more info.

@FaithOmbongi FaithOmbongi added the blocked PRs that are blocked from content review or getting merged for some reason. label Apr 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

blocked PRs that are blocked from content review or getting merged for some reason.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants