Example usage
The following is a sample ArcGIS Online request URL used to access an individual group resource:
https://www.arcgis.com/sharing/rest/community/groups/2ecb37a8c8fb4051af9c086c25503bb0
The following is a sample ArcGIS Enterprise request URL used to access an individual group resource:
https://machine.domain.com/webadaptor/sharing/rest/community/groups/2ecb37a8c8fb4051af9c086c25503bb0
Description
An individual group resource represents a group within the organization. The group owner is automatically an administrator and is returned in the list of administrators. Administrators can invite, add to, or remove members from a group as well as update or delete the group. The administrator for an organization can also reassign the group to another member of the organization.
The visibility of the group by other users is determined by the access property. If the group is private, no one other than the administrators and members of the group will be able to see it. If the group is shared with an organization, all members of the organization will be able to find it.
Group members can leave the group. Authenticated users can apply to join a group unless the group is by invitation only.
Request parameters
Parameter | Details |
---|---|
[Common Parameters] | For a complete listing, see Common parameters. |
f | The response format. The default format is html. Values: html | json | pjson |
Response properties
Property | Details |
---|---|
id | The given group ID. |
title | The title of the group. This is the name that is displayed to users and by which they refer to the group. Every group must have a title, and it must be unique for a user. |
isInvitationOnly | If this is set to true, users will not be able to apply to join the group. |
orgId | Organization ID. |
owner | The owner user name of the group. |
description | The group description. |
typeKeywords | An array of keywords that further describes a group. |
snippet | The group summary. |
tags | User-defined tags that describe the group. |
phone | The contact information for the group. |
sortField | The sorted field. |
sortOrder | The sort order, either descending or ascending. |
isViewOnly | Boolean value indicating whether the results are only for viewing. |
isFav | Boolean value indicating whether marked in favorites. |
thumbnail | The URL to the thumbnail used for the group. All group thumbnails are relative to the URL: https://www.arcgis.com/sharing/rest/community/groups/[groupID]/info. |
created | The date the group was created. Shown in UNIX time in milliseconds. |
modified | The date the group was last modified. Shown in UNIX time in milliseconds. |
access | The access privileges of the group that determine who can see and access the group. This can be set to private, org, or public. |
userMembership | If the request is made by an authenticated user, a JSON object is returned containing information about the user's access to the group. This includes the username of the calling user; the memberType, which specifies the type of membership the user has in the group (owner, member, admin, none); and the applications (number of requests to join the group) count available to administrators and owners. |
protected | Indicates if the group is protected from deletion. The default value is false. |
autoJoin | Only applies to org accounts. Indicates if the group allows joining without requesting membership approval. The default value is false. |
hasCategorySchema | If true, the group has content category set. |
isOpenData | If true, the group is designated as available for use in Open Data sites. |
JSON Response syntax
{
"id": "<group id>",
"title": "<group title>",
"isInvitationOnly": true |false,
"orgId":"<organization ID>",
"owner": "<group owner username>",
"description": "<description>",
"snippet": <summary>,
"tags": [
"<tag1>",
"<tag2>",
"<tag3>"
],
"typeKeywords": [
"<typeKeyword1>",
"<typeKeyword2>"
],
"phone": <contact>,
"sortField": "title",
"sortOrder": "asc",
"isViewOnly": false,
"isFav": false,
"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
},
"protected": true | false,
"autoJoin": true | false,
"hasCategorySchema": true,
"isOpenData": true
}
JSON Response example
{
"id": "2ecb37a8c8fb4051af9c086c25503bb0",
"title": "Street Maps",
"isInvitationOnly": false,
"orgId": "J423vH8fR9HV444l",
"owner": "jsmith",
"description": "The street maps group provides street maps for the city of Redlands.",
"snippet": null,
"tags": [
"Redlands",
"Street",
"Maps"
],
"typeKeywords": [
"Transportation",
"Public"
],
"phone": "jsmith@esri.com",
"sortField": "title",
"sortOrder": "asc",
"isViewOnly": false,
"isFav": false,
"thumbnail": "streets.jpg",
"created": 1247082196000,
"modified": 1276793808000,
"access": "public",
"userMembership": {
"username": "jsmith",
"memberType": "owner",
"applications": 1
},
"protected": true,
"autoJoin": false,
"hasCategorySchema": true
}