Send Sharing Invitation - retainInheritedPermissions property failing

Serdar Kilic 45 Reputation points

When sending a sharing invitation for a driveItem the documentation ( mentions that you are able to indicate if you want the permissions to inherit by setting the property retainInheritedPermissions to true or false. When sending this property through it results in an invalidRequest. If it is omitted, the request succeeds (alas without the permission inheritance).

POST /v1.0/drives/{driveID}/items/{itemId}/invite HTTP/1.1


    "recipients": [
            "email": ""
    "requireSignIn": true,
    "sendInvitation": false,    
    "retainInheritedPermissions": false,
    "roles": [

Error message:

    "error": {
        "code": "invalidRequest",
        "message": "Invalid request",
        "innerError": {
            "date": "2023-04-06T02:40:11",
            "request-id": "xxxxxxxx",
            "client-request-id": "xxxxx"
Microsoft Graph
Microsoft Graph
A Microsoft programmability model that exposes REST APIs and client libraries to access data on Microsoft 365 services.
10,808 questions
A group of Microsoft Products and technologies used for sharing and managing content, knowledge, and applications.
9,836 questions
{count} vote

Accepted answer
  1. Gopinath Chennamadhavuni 2,431 Reputation points

    Hi Serdar Kilic Thanks for reaching out. I am able to replicate the issue from my test tenant. I would recommend you report this by raising a support case with Microsoft, a dedicated Support Engineer will be able to assist you better. You can raise support ticket from or Hope this helps.  If the answer is helpful, please click Accept Answer and kindly upvote. If you have any further questions about this answer, please click Comment.

    1 person found this answer helpful.

3 additional answers

Sort by: Most helpful
  1. Serdar Kilic 45 Reputation points

    I haven't seen it elsewhere nor have they mentioned it, and checking the documentation it still hasn't been updated to reflect their response.

    0 comments No comments

  2. Vinanth S Bharadwa 26 Reputation points

    The request will be succeeded if you add 'Prefer' header for value “apiversion=2.1”.

    User's image

    0 comments No comments

  3. Vinanth S Bharadwa 26 Reputation points

    The request succeeds if you add 'Prefer' header for value “apiversion=2.1”.

    User's image

    0 comments No comments