- URL:https://[root]/content/items/[itemID]/share(POST only)
- Required Capability:Group Owner | Administrator
Example usage
The following is a sample ArcGIS Online POST request for the share operation
POST /sharing/rest/content/items/af01df44bf36437fa8daed01407138ab/share HTTP/1.1
Host: org.arcgis.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
groups=bf51aa6e879e4676b683dcbefb0ab0a9,cc5f73ab367544d6b954d82cc9c6dab7&confirmItemControl=false&f=pjsonThe following is a sample ArcGIS Enterprise POST request for the share operation:
POST /webadaptor/sharing/rest/content/items/af01df44bf36437fa8daed01407138ab/share HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
groups=bf51aa6e879e4676b683dcbefb0ab0a9,cc5f73ab367544d6b954d82cc9c6dab7&confirmItemControl=false&f=pjsonDescription
The share operation shares an item with a public or organization sharing level with groups either owned or administered by the user performing the request. If the shared items are owned by the user, this operation acts the same as the Share Item (as item owner) operation.
Nota:
Administrators may share an item to a group on the owners behalf. There are no sharing restrictions if the item has a public or org sharing level. The items with a private sharing level may only be shared to groups the item owner has sharing access to.
Request parameters
| Parameter | Details |
|---|---|
| [Common Parameters] | For a complete listing, see Common parameters. |
| groups | A comma-separated list of group IDs with which the item will be shared. |
| confirmItemControl | Set to true when the items will be shared with groups that have the item update capability, which allows any member of the group to update the shared items. Values: true | false |
Response properties
| Property | Details |
|---|---|
| notSharedWith | Array of groups with which the item could not be shared. |
| itemId | ID of the item being shared. |
JSON Response syntax
{
"notSharedWith": [<groups not able to share with>],
"itemId": "<item id>"
}JSON Response example
{
"notSharedWith": ["cc5f73ab367544d6b954d82cc9c6dab7"],
"itemId": "af01df44bf36437fa8daed01407138ab"
}