---
title: Modifier les privilèges de partage de groupe
slug: modifier-les-privileges-de-partage-de-groupe
docTags: 
createdAt: 2026-06-04T15:50:56.155Z
---

{
  "id": "i0nUaRaS15x_jzJJQMUSY",
  "type": "api-oas-v2",
  "data": {
    "method": "PUT",
    "url": "https://api.ionos.com/cloudapi/v6/um/groups/{groupId}/shares/{resourceId}",
    "servers": [
      {
        "url": "https://api.ionos.com/cloudapi/v6/um/groups/{groupId}/shares/{resourceId}"
      }
    ],
    "name": "Modify group share privileges",
    "description": "<p>Modify share permissions for the specified group. With an empty body, no updates are performed, and the current share permissions for the group are returned with response code 200.</p>",
    "contentType": "application/json",
    "request": {
      "pathParameters": [
        {
          "kind": "required",
          "name": "groupId",
          "type": "string",
          "description": "The unique ID of the group."
        },
        {
          "kind": "required",
          "name": "resourceId",
          "type": "string",
          "description": "The unique ID of the resource."
        }
      ],
      "headerParameters": [
        {
          "name": "accept",
          "type": "string",
          "kind": "optional",
          "description": "Generated from available response content types",
          "enum": [
            "application/json"
          ],
          "default": "application/json"
        },
        {
          "kind": "optional",
          "name": "X-Contract-Number",
          "type": "integer<int32>",
          "description": "<p>Users with multiple contracts must provide the contract number, for which all API requests are to be executed.</p>",
          "format": "int32"
        }
      ],
      "queryParameters": [
        {
          "kind": "optional",
          "name": "pretty",
          "type": "boolean",
          "description": "<p>Controls whether the response is pretty-printed (with indentations and new lines).</p>",
          "default": true
        },
        {
          "kind": "optional",
          "name": "depth",
          "type": "integer<int32>",
          "description": "<p>Controls the detail depth of the response objects. NOTE: The resource /um and its children support a maximum depth level of 1. It will provide you the entry points to specific user related resources. As these resources are partially servered by other service components, they must be retrieved explicitly. Any depth parameter beyond '?depth=1' will be deprecated by April 30, 2026.</p>",
          "default": 0,
          "format": "int32",
          "minimum": 0,
          "maximum": 1
        }
      ],
      "bodyDataParameters": [
        {
          "kind": "required",
          "name": "body",
          "type": "object",
          "description": "The modified resource",
          "customType": "GroupShare",
          "schema": [
            {
              "name": "properties",
              "kind": "required",
              "type": "object",
              "description": "",
              "modelRef": "#/components/schemas/GroupShareProperties",
              "customType": "GroupShareProperties",
              "schema": [
                {
                  "name": "editPrivilege",
                  "kind": "optional",
                  "type": "boolean",
                  "description": "edit privilege on a resource"
                },
                {
                  "name": "sharePrivilege",
                  "kind": "optional",
                  "type": "boolean",
                  "description": "share privilege on a resource"
                }
              ]
            }
          ],
          "modelRef": "#/components/schemas/GroupShare",
          "isExpanded": true
        }
      ],
      "formDataParameters": [],
      "oAuthParameters": [
        {
          "id": "BasicAuthentication",
          "name": "BasicAuthentication",
          "kind": "optional",
          "type": "http",
          "description": "<p>You will need to base64 encode the string containing your credentials. \nNote:\n\n</p>",
          "scheme": "basic"
        },
        {
          "id": "TokenAuthentication",
          "name": "Authorization",
          "kind": "optional",
          "type": "apiKey",
          "description": "<p>Please provide header value as 'Bearer ' and don't forget to add 'Bearer' HTTP Authorization Scheme before the token.</p>",
          "in": "header"
        }
      ],
      "cookieParameters": []
    },
    "responses": [
      {
        "statusCode": "202",
        "description": "Successful operation",
        "jsonExample": "",
        "isExpanded": true,
        "headers": [
          {
            "kind": "optional",
            "name": "X-RateLimit-Remaining",
            "type": "integer<int32>",
            "description": "The number of requests that can still be made without triggering a failure response.",
            "format": "int32"
          },
          {
            "kind": "optional",
            "name": "X-RateLimit-Limit",
            "type": "integer<int32>",
            "description": "The average number of requests per minute allowed.",
            "format": "int32"
          },
          {
            "kind": "optional",
            "name": "X-RateLimit-Burst",
            "type": "integer<int32>",
            "description": "The maximum number of concurrent API requests allowed.",
            "format": "int32"
          },
          {
            "kind": "optional",
            "name": "Location",
            "type": "string",
            "description": "Callback URL to poll async operation status.",
            "pattern": "https://[apiBaseUri]/requests/[requestId]/status"
          }
        ],
        "schema": [
          {
            "kind": "optional",
            "type": "object",
            "description": "",
            "customType": "GroupShare",
            "schema": [
              {
                "name": "id",
                "kind": "optional",
                "type": "string",
                "readOnly": true,
                "description": "The resource's unique identifier.",
                "example": "15f67991-0f51-4efc-a8ad-ef1fb31a480c"
              },
              {
                "name": "type",
                "kind": "optional",
                "type": "object",
                "readOnly": true,
                "description": "",
                "complexType": "allOf",
                "complexItems": [
                  {
                    "name": "Type",
                    "description": "",
                    "modelRef": "#/components/schemas/Type",
                    "schema": []
                  }
                ],
                "schema": []
              },
              {
                "name": "href",
                "kind": "optional",
                "type": "string<uri>",
                "readOnly": true,
                "description": "<p>URL to the object representation (absolute path).</p>",
                "example": "https://<API_HOST>/cloudapi/v6/um/groups/15f67991-0f51-4efc-a8ad-ef1fb31a480c/shares/17faab13-13abc-4efc-a8ad-ef1fb31a481b",
                "format": "uri"
              },
              {
                "name": "properties",
                "kind": "required",
                "type": "object",
                "description": "",
                "modelRef": "#/components/schemas/GroupShareProperties",
                "customType": "GroupShareProperties",
                "schema": [
                  {
                    "name": "editPrivilege",
                    "kind": "optional",
                    "type": "boolean",
                    "description": "edit privilege on a resource"
                  },
                  {
                    "name": "sharePrivilege",
                    "kind": "optional",
                    "type": "boolean",
                    "description": "share privilege on a resource"
                  }
                ]
              }
            ],
            "modelRef": "#/components/schemas/GroupShare",
            "isExpanded": true
          }
        ]
      },
      {
        "statusCode": "default",
        "description": "<p>Any erroneous status code: 400 (parse error), 401 (auth error), 402 (trial access), 403 (insufficient privileges), 404 (not found), 405 (unsupported HTTP method), 415 (unsupported content type, 422 (validation error), 429 (request rate limit exceeded), 500 (server error), or 503 (maintenance).</p>",
        "jsonExample": "",
        "isExpanded": true,
        "schema": [
          {
            "kind": "optional",
            "type": "object",
            "description": "",
            "customType": "Error",
            "schema": [
              {
                "name": "httpStatus",
                "kind": "optional",
                "type": "integer<int32>",
                "readOnly": true,
                "description": "HTTP status code of the operation.",
                "example": 400,
                "format": "int32"
              },
              {
                "name": "messages",
                "kind": "optional",
                "type": "array",
                "description": "",
                "modelRef": "#/components/schemas/ErrorMessage",
                "customType": "ErrorMessage[]",
                "schema": [
                  {
                    "name": "errorCode",
                    "kind": "optional",
                    "type": "string",
                    "readOnly": true,
                    "description": "Application internal error code.",
                    "example": "123"
                  },
                  {
                    "name": "message",
                    "kind": "optional",
                    "type": "string",
                    "readOnly": true,
                    "description": "<p>A human-readable message.</p>",
                    "example": "Error message example."
                  }
                ]
              }
            ],
            "modelRef": "#/components/schemas/Error",
            "isExpanded": true
          }
        ]
      }
    ],
    "hasXCodeSamples": false,
    "examples": {
      "languages": [
        {
          "id": "3CUbHP25_9FTWLCxB8rA0",
          "language": "curl",
          "label": "cURL",
          "code": "curl --request PUT \\\n     --url 'https://api.ionos.com/cloudapi/v6/um/groups/{groupId}/shares/{resourceId}?pretty=true&depth=integer%3Cint32%3E' \\\n     --header 'accept: application/json' \\\n     --header 'content-type: application/json' \\\n     --data '{\n     \"properties\": {}\n     }'"
        },
        {
          "id": "nSkHYdcWy4qngzI_VZ91b",
          "language": "javascript",
          "label": "javascript",
          "code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar raw = JSON.stringify({\n   \"properties\": {}\n});\n\nvar requestOptions = {\n   method: 'PUT',\n   headers: myHeaders,\n   body: raw,\n   redirect: 'follow'\n};\n\nfetch(\"https://api.ionos.com/cloudapi/v6/um/groups/{groupId}/shares/{resourceId}?pretty=true&depth=integer<int32>\", requestOptions)\n   .then(response => response.text())\n   .then(result => console.log(result))\n   .catch(error => console.log('error', error));"
        },
        {
          "id": "99oY5FNgpK5mvxFj0z8la",
          "language": "ruby",
          "label": "Ruby",
          "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.ionos.com/cloudapi/v6/um/groups/{groupId}/shares/{resourceId}?pretty=true&depth=integer<int32>\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Put.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\nrequest.body = JSON.dump({\n   \"properties\": {}\n})\n\nresponse = https.request(request)\nputs response.read_body\n"
        },
        {
          "id": "Gb2KRzxzp6AyFfLitNRUw",
          "language": "python",
          "label": "Python",
          "code": "import requests\nimport json\n\nurl = \"https://api.ionos.com/cloudapi/v6/um/groups/{groupId}/shares/{resourceId}?pretty=true&depth=integer<int32>\"\n\npayload = json.dumps({\n   \"properties\": {}\n})\nheaders = {\n   'accept': 'application/json',\n   'content-type': 'application/json'\n}\n\nresponse = requests.request(\"PUT\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
        }
      ],
      "selectedLanguageId": "3CUbHP25_9FTWLCxB8rA0"
    },
    "results": {
      "languages": [
        {
          "id": "4t8766egkEyOw7TQvbiQH",
          "language": "202",
          "code": "// Successful operation\n{\n  \"id\": \"15f67991-0f51-4efc-a8ad-ef1fb31a480c\",\n  \"type\": {},\n  \"href\": \"https://<API_HOST>/cloudapi/v6/um/groups/15f67991-0f51-4efc-a8ad-ef1fb31a480c/shares/17faab13-13abc-4efc-a8ad-ef1fb31a481b\",\n  \"properties\": {\n    \"editPrivilege\": false,\n    \"sharePrivilege\": false\n  }\n}"
        },
        {
          "id": "zTEtBlPwVkiDP9reksZuj",
          "language": "default",
          "code": "// Any erroneous status code: 400 (parse error), 401 (auth error), 402 (trial access), 403 (insufficient privileges), 404 (not found), 405 (unsupported HTTP method), 415 (unsupported content type, 422 (validation error), 429 (request rate limit exceeded), 500 (server error), or 503 (maintenance).\n{\n  \"httpStatus\": 400,\n  \"messages\": [\n    {\n      \"errorCode\": \"123\",\n      \"message\": \"Error message example.\"\n    }\n  ]\n}"
        }
      ],
      "selectedLanguageId": "4t8766egkEyOw7TQvbiQH"
    }
  },
  "children": [
    {
      "text": "",
      "id": "JloFvhyZJee0i20HMymEG"
    }
  ]
}