/share: Share Item (as group admin)

URL:: https://[root]/content/items/[itemID]/share
Methods:: POST
Required Capability:: Group Owner | Administrator

Example usage

The following is a sample ArcGIS Online POST request for the share operation

Use dark colors for code blocksCopy
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=pjson

The following is a sample ArcGIS Enterprise POST request for the share operation:

Use dark colors for code blocksCopy
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=pjson

Description

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.

Request parameters

Parameter Details

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`

[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

Use dark colors for code blocksCopy
{
  "notSharedWith": [<groups not able to share with>],
  "itemId": "<item id>"
}

JSON Response example

Use dark colors for code blocksCopy
{
  "notSharedWith": ["cc5f73ab367544d6b954d82cc9c6dab7"],
  "itemId": "af01df44bf36437fa8daed01407138ab"
}