Skip To Content

/groups (item): Groups

  • URL:https://[root]/content/items/[itemID]/groups
  • Version Introduced:2.1

Example Usage

URL for Groups

https://www.arcgis.com/sharing/rest/content/items/af01df44bf36437fa8daed01407138ab/groups

Description

Lists the groups of which the item is a part. Only shows the groups that the calling user can access.

Request Parameters

ParameterDetails
[Common Parameters]

For a complete listing, see Common parameters.

Response Properties

PropertyDetails
admin

Groups which user is an administrator. This is a JSON Array of group objects. See Group for possible response properties.

member

Groups which user is a member.

other

Other groups that are public or shared to the user's organization but that the user is not a member of.

JSON Response Syntax

{
"admin":[{
  "id": "<group id>",
  "title": "<group title>",
  "isInvitationOnly": true |false,
  "owner": "<group owner username>",
  "description": "<description>",
  "snippet": <summary>,
  "tags": [
    "<tag1>",
    "<tag2>",
    "<tag3>"
  ],
  "phone": contact, 
  "thumbnail": file name,
  "created": date created shown in UNIX time,
  "modified": date modified shown in UNIX time,  
  "access": private | org | public,
  "userMembership": {   //available only if request is made by an authenticated user
    "username": "<requestor username>",
    "memberType": "owner | member |admin | none",
    "applications": number of applications  //available only to admins and owners
  }
}],
"member":[

{ "id": "<group id>",
  "title": "<group title>",
  "isInvitationOnly": true |false,
  "owner": "<group owner username>",
  "description": "<description>",
  "snippet": <summary>,
  "tags": [
    "<tag1>",
    "<tag2>",
    "<tag3>"
  ],
  "phone": contact, 
  "thumbnail": file name,
  "created": date created shown in UNIX time,
  "modified": date modified shown in UNIX time,  
  "access": private | org | public,
  "userMembership": {   //available only if request is made by an authenticated user
    "username": "<requestor username>",
    "memberType": "owner | member |admin | none",
    "applications": number of applications  //available only to admins and owners
  }
}],

"other":[

{  "id": "<group id>",
  "title": "<group title>",
  "isInvitationOnly": true |false,
  "owner": "<group owner username>",
  "description": "<description>",
  "snippet": <summary>,
  "tags": [
    "<tag1>",
    "<tag2>",
    "<tag3>"
  ],
  "phone": contact, 
  "thumbnail": file name,
  "created": date created shown in UNIX time,
  "modified": date modified shown in UNIX time,  
  "access": private | org | public,
  "userMembership": {   //available only if request is made by an authenticated user
    "username": "<requestor username>",
    "memberType": "owner | member |admin | none",
    "applications": number of applications  //available only to admins and owners
  }
}]
}

JSON Response Example

{
"admin":[{
  "id": "2ecb37a8c8fb4051af9c086c25503bb0",
  "title": "Street Maps",
  "isInvitationOnly": false,
  "owner": "jsmith",
  "description": "The street maps group provides street maps for the city of Redlands.",
  "snippet": null,
  "tags": [
    "Redlands",
    "Street",
    "Maps"
  ],
  "phone": https://www.esri.com, 
  "thumbnail": "streets.jpg",
  "created": 1247082196000,
  "modified": 1276793808000,
  "access": "public",
  "userMembership": {
    "username": "jsmith",
    "memberType": "owner",
    "applications": 1
  }
}],
"member":[

  "id": "bf51aa6e879e4676b683dcbefb0ab0a9",
  "title": "Parks and Recreation",
  "isInvitationOnly": true,
  "owner": "swilson",
  "description": "The Parks and Recreation group contains maps and applications used by the Parks Department.",
  "snippet": null,
  "tags": [
    "Redlands",
    "Parks",
    "Recreation"
  ],
  "phone": https://www.esri.com, 
  "thumbnail": "parks.jpg",
  "created": 1247082197000,
  "modified": 1276793919000,
  "access": "private",
  "userMembership": {
    "username": "jsmith",
    "memberType": "member",
  }
}],
"other":[

  "id": "dbc385ac1b7d4231b24b97750f0e633c",
  "title": "Featured Maps and Apps",
  "isInvitationOnly": true,
  "owner": "city_redlands",
  "description": "These items are featured on the gallery page.",
  "snippet": null,
  "tags": [
     "gallery",
      "Featured Maps",
      "Featured Apps"
    ],
    "phone": https://www.esri.com, 
    "thumbnail": "gallery.jpg",
    "created": 1327099662000,
    "modified": 1327099662000,
    "access": "public",
    "userMembership": {
      "username": "jsmith",
      "memberType": "none"
    }
  }]
}