- URL:
- https://[root]/portals/[portalID]/createRole
- Methods:
POST
Example usage
The following is a sample ArcGIS Online POST request for the create operation:
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=pjsonThe following is a sample ArcGIS Enterprise POST request for the create operation:
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=pjsonDescription
The create 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
| Parameter | Details |
|---|---|
| The name for the custom role. It can contain up to 128 characters. Example |
| The description for the role. It can be up to 250 characters. Example |
| The response format. The default format is Values: |
Response properties
| Property | Details |
|---|---|
| Indicates if the operation was successful. |
| The ID of the role. |
JSON Response syntax
{
"success": true | false,
"id": "<role id>"
}JSON Response example
{
"success": true,
"id": "edgebRxFLiLt15df"
}