/createRole: Create Role

URL:
https://[root]/portals/[portalID]/createRole
Methods:
POST

Example usage

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

1
2
3
4
5
6
POST /sharing/rest/portals/0123456789ABCDEF/createRole HTTP/1.1
Host: org.arcgis.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

name=Custom Viewer Role&description=Custom viewer role for your organization&f=pjson

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

1
2
3
4
5
6
POST /webadaptor/sharing/rest/portals/0123456789ABCDEF/createRole HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

name=Custom Viewer Role&description=Custom viewer role for your organization&f=pjson

Description

The createRole operation creates a new custom role where a more fine-grained set of privileges can be defined with the set role privileges operation. The operation is only available to members assigned the default administrator role.

Request parameters

ParameterDetails

name

The name for the custom role. It can contain up to 128 characters.

Example

1
name=Custom Viewer Role

description

The description for the role. It can be up to 250 characters.

Example

1
description=Custom viewer role for your organization

f

The response format. The default format is html.

Values: html | json | pjson

Response properties

PropertyDetails

success

Indicates if the operation was successful.

id

The ID of the role.

JSON Response syntax

1
2
3
4
{
  "success": true | false,
  "id": "<role id>"
}

JSON Response example

1
2
3
4
{
  "success": true,
  "id": "edgebRxFLiLt15df"
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close