Modify permissions JSON structure in API documentation

[JonasSupplie]

Updated the JSON structure for granting permissions in the DriveItem API.

the current request example is wrong and will result into error "Property grantedToIdentitiesV2 in payload has a value that does not match schema." or "'grantedTo' must be provided"

Important

Required for API changes:

• [] Link to API.md file: ADD LINK HERE
• [] Link to PR for public-facing schema changes (schema-Prod-beta/v1.0.csdl): ADD LINK HERE

---

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.

[learn-build-service-prod]

Learn Build status updates of commit 55810bd:

✅ Validation status: passed

File	Status	Preview URL	Details
api-reference/beta/api/driveitem-post-permissions.md	✅Succeeded

For more details, please refer to the build report.

[FaithOmbongi]

Thank you @JonasSupplie for spotting the error in the sample. Could you also fix the payload? Thank you.

[microsoft-github-policy-service]

Hello @@JonasSupplie! This pull request has been inactive for 2 weeks with the changes requested label. Please address the feedback left by your reviewer and add the review feedback addressed. If you have any questions, please contact your reviewer.

• If you are still working on this pull request, please add a comment or push changes. Remove changes requested and add review feedback addressed once you've made all requested changes.
• If the pull request is no longer needed, please close it.
• If the pull request is on hold or otherwise blocked, please add the blocked label.

Note

Pull requests that are inactive more than 6 weeks will be automatically closed.

[microsoft-github-policy-service]

Hello @@JonasSupplie! This pull request has been inactive for 4 weeks with the changes requested label. Please address the feedback left by your reviewer and add the review feedback addressed. If you have any questions, please contact your reviewer.

• If you are still working on this pull request, please add a comment or push changes. Remove changes requested and add review feedback addressed once you've made all requested changes.
• If the pull request is no longer needed, please close it.
• If the pull request is on hold or otherwise blocked, please add the blocked label.

Note

Pull requests that are inactive more than 6 weeks will be automatically closed.

[microsoft-github-policy-service]

Hello @@JonasSupplie! This pull request has been inactive for 6 weeks with the changes requested label. Please address the feedback left by your reviewer and add the review feedback addressed. If you have any questions, please contact your reviewer.

• If you are still working on this pull request, please add a comment or push changes. Remove changes requested and add review feedback addressed once you've made all requested changes.
• If the pull request is no longer needed, please close it.
• If the pull request is on hold or otherwise blocked, please add the blocked label.

Note

This pull request will be automatically closed in 7 days if you do not take action.