- URL:
- https://[root]/portals/[portalID]/roles/[roleID]/setPrivileges
- Methods:
POST
Example usage
The following is a sample ArcGIS Online request URL for the set operation:
POST /sharing/rest/portals/0123456789ABCDEF/roles/edgebRxFLiLt15df/setPrivileges HTTP/1.1
Host: org.arcgis.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
privileges={"privileges": ["portal:user:createItem","portal:user:joinGroup"]}&f=pjsonThe following is a sample ArcGIS Enterprise request URL for the set operation:
POST /<context>/sharing/rest/portals/0123456789ABCDEF/roles/edgebRxFLiLt15df/setPrivileges HTTP/1.1
Host: organization.example.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
privileges={"privileges": ["portal:user:createItem","portal:user:joinGroup"]}&f=pjsonDescription
The set operation allows default organization administrators to set privileges for a custom role.
Request parameters
| Parameter | Details |
|---|---|
| A JSON object that contains an array of strings with predefined permissions within each. See the General privileges and Administrative privileges sections below for more information on all available role privileges. Example |
| The response format. The default format is Values: |
General privileges
The following tables outline the supported, general privileges in ArcGIS Online and ArcGIS Enterprise.
Members
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability to view members of the organization. |
Groups
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability for a member to create, edit, and delete their own groups. | ||
| Grants the ability to join groups within the organization. | ||
| Grants the ability to join groups external to the organization. | ||
| Grants the ability to view groups shared with the organization. | ||
| Grants the ability to invite members from partnered collaboration organizations to groups. | ||
| Grants the ability to create groups that allow members from other organizations, as well as invite external members to groups. |
Content
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability for a member to create, edit, and delete their own content. | ||
| Grants the ability to publish hosted feature layers from shapefiles, CSV files, and so on. This privilege is required when using apps that create hosted feature layers, such as ArcGIS Survey 123 and ArcGIS Workforce. | ||
| Grants the ability to publish hosted tile layers from tile packages, features, and so on. | ||
| Grants the ability to publish hosted scene layers. | ||
| Grants the ability to publish hosted tiled imagery layers from a single image or collection of images, and allows members to export a tile package from a hosted tiled imagery layer. This privilege requires an ArcGIS Image for ArcGIS Online user type extension license. | ||
| Grants the ability to publish hosted dynamic imagery layers from a single image or collection of images. For ArcGIS Enterprise organizations, this privilege requires that your deployment be configured for raster analysis. | ||
| Grants the ability to publish ArcGIS Server web layers to ArcGIS Server sites that are federated with the portal. These services often reference registered data from geodatabases or file-based data sources. This privilege is also required for members who will bulk publish layers from a data store item. | ||
| Grants the ability to publish hosted knowledge graphs in ArcGIS Pro. This privilege is only visible if an ArcGIS Knowledge Server is configured for your organization. | ||
| Grants the ability to view content shared with the organization. | ||
| Grants the ability to add data store items to the portal. | ||
| Grants the owner of a database data store item the ability to publish feature and map layers from all feature classes and tables that can be accessed in the database. | ||
| Grants the ability to view members' location tracks via shared track views when location tracking is enabled. | ||
| Grants the ability to publish feeds to collect and display real-time data using ArcGIS Velocity. This privilege applies only to the organizations with ArcGIS Velocity license. | ||
| Grants the ability to publish real-time analytics to analyze and process real-time data using ArcGIS Velocity. This privilege applies only to the organizations with ArcGIS Velocity license. | ||
| Grants the ability to publish big data analytics to analyze historical observation data using ArcGIS Velocity. This privilege applies only to the organizations with ArcGIS Velocity license. | ||
| Grants the ability to create and edit interactive notebook documents. For ArcGIS Enterprise organizations, this privilege is only visible if ArcGIS Notebook Server is configured for your organization. This privilege is required for users who will be running web tools published from a notebook. | ||
| Grants the ability to schedule notebooks. For ArcGIS Enterprise organizations, this privilege is only visible if ArcGIS Notebook Server is configured for your organization. | ||
| Introduced at ArcGIS Enterprise 11.0. Grants a user the ability to reassign only their content to another member with the privilege to receive content. | ||
| Introduced at ArcGIS Enterprise 11.0. Grants a user the ability to receive content that is reassigned to them by another member with the privilege to reassign content. | ||
| Grants the ability to create, edit, and run data pipelines. ArcGIS Online organizations must have a subscription type that supports ArcGIS Data Pipelines. This privilege was introduced to ArcGIS Enterprise at 12.0. This privilege is only available to ArcGIS Enterprise organizations that have configured ArcGIS Data Pipelines for their organization. | ||
| Introduced at ArcGIS Enterprise 11.2. Grants a user the ability to publish hosted video layers from video file and supported video metadata files. | ||
| Introduced at ArcGIS Enterprise 11.2. Grants a user the ability to publish hosted livestream video layers sourced from network video broadcasts and streams. | ||
| Introduced at ArcGIS Enterprise 11.4. Grants the ability for a member to generate API keys. | ||
| Introduced at ArcGIS Enterprise 11.4. Grants ability for a member to assign privileges to OAuth 2.0 applications. |
Sharing
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants an organization member the ability to share their owned content with any groups to which they belong. | ||
| Grants organization members the ability to share any items they own with their organization. | ||
| Grants organization members the ability to share any items they own with everyone, including the public. | ||
| Grants the ability for any group a member makes to be discoverable. It is recommended that this privilege be assigned to members who also have the | ||
| Grants the ability to make any group owned by an organization member visible to everyone in the organization, including the public and allowing for anonymous portal users to view the group. It is recommended that this privilege be assigned to members who also have the | ||
| Grants the ability to designate groups in the organization as being available for use in Open Data. |
Premium Content | Content and Analysis
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability to perform large-volume geocoding tasks with the Esri World Geocoder, such as publishing a CSV file of addresses as a hosted feature layer. | ||
| Grants the ability to perform network analysis tasks such as routing and drive-time areas. | ||
| Grants the ability to perform spatial analysis tasks. | ||
| Grants the ability to geoenrich features. | ||
| Grants the ability to make use of premium demographic data. | ||
| Grants the ability to perform GeoAnalytics tasks. | ||
| Grants the ability to perform imagery and raster analysis tasks such as calculating slope. This requires an ArcGIS Image for ArcGIS Online user type extension license. | ||
| Grants the ability to create feature reports in ArcGIS Survey123. | ||
| Grants the ability to import and use ArcPy modules in notebooks. | ||
| Grants the ability to run web tools published from notebooks. | ||
| Grants the ability to perform local place, or point of interest search with the new places-service (beta). Available for developer subscriptions only. |
Features
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability to edit features in editable layers based on a layer's permissions. For ArcGIS Enterprise organizations, this privilege also grants the ability to update schema on a knowledge graph layer. | ||
| Grants the ability to add, delete, and update features and attributes in a hosted feature layer regardless of the editing options enabled on the layer. |
Version Management
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability to view, alter, and delete all branch versions accessed through an ArcGIS Server web feature layer, as well as the ability to manage version locks. |
Webhooks
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability to create, edit, and delete their own feature layer webhooks. |
Administrative privileges
The following tables outline the supported, administrative privileges in ArcGIS Online and ArcGIS Enterprise
Members
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability to view full member account information in the organization. | ||
| Grants the ability to update member account information, reset passwords, and assign or unassign member categories. Only members assigned the default administrator role can edit the password of another member who has also been assigned the default administrator role. A member with a custom role that includes | ||
| Grants the ability to delete member accounts in the organization. | ||
| Grants the ability to invite members to the organization. | ||
| Grants the ability to enable and disable member accounts in the organization. | ||
| Grants the ability to change the role a member is assigned in the organization; however, it does not grant the ability to promote a member to, or demote a member from, the default administrator role. That privilege is reserved for only members assigned the default administrator role. | ||
| Grants the ability to manage licenses for organization members. | ||
| Grants the ability to configure the organization member category schema. |
Groups
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability to view all groups in the organization. | ||
| Grants the ability to update groups in the organization. | ||
| Grants the ability to delete groups in the organization. | ||
| Grants the ability to reassign groups to other members in the organization. | ||
| Grants the ability to assign members to, and remove members from, groups in the organization. | ||
| Grants the ability to link group membership to organization-specific groups. | ||
| Grants the ability to create and own groups that allow group members to update al items in the group (shared update groups). | ||
| Introduced at 11.3. Grants the ability for members to create and own groups that do not allow members to leave (administrative groups). |
Content
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability to view all content in the organization. | ||
| Grants the ability to update and categorize content in the organization and edit hosted feature layers in your organization. | ||
| Grants the ability to delete content in the organization. | ||
| Grants the ability to reassign content to other members in the organization. | ||
| Grants the ability to configure the organization content category schema. | ||
| Grants the ability to publish web tools to the organization. | ||
| Grants the ability to share other members' content to the organization. | ||
| Grants the ability to share other members' content to all users of the portal. | ||
| Introduced at 11.3. Grants the ability to create and manage administrative reports. |
Marketplace subscriptions
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability to create listings and list items and manage subscriptions in ArcGIS Marketplace. | ||
| Grants the ability to request purchase information about apps and data in ArcGIS Marketplace. | ||
| Grants the ability to start trial subscriptions in ArcGIS Marketplace. |
Webhooks
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability to create, edit, and delete geoprocessing webhooks. |
Organization settings
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability to manage the portal's security settings. | ||
| Grants the ability to manage the organization's website settings. | ||
| Grants the ability to manage the organization's collaborations. | ||
| Grants the ability to manage the organization's credit budgeting settings. | ||
| Grants the ability to manage the organization's member roles. | ||
| Grants the ability to manage the portal's server settings. | ||
| Grants the ability to manage the organization's utility service settings. | ||
| Grants the ability to create, edit, and delete organizational webhooks and manage all webhooks within the portal. |
Open data
| Privilege | ArcGIS Online | ArcGIS Enterprise | Description |
|---|---|---|---|
| Grants the ability to manage Open Data Sites for the organization. |
JSON Response syntax
{
"success": <true | false>
}JSON Response example
{
"success": true
}