- URL:
 - https://<root>/security/roles/add
 - Methods:
 POST- Required Capability:
 - Access allowed with either the "Update", "Delete", "Security and Infrastructure", or "Servers" privileges
 - Version Introduced:
 - 10.1
 
Description
The add operation adds a role to the role store. This operation is available only when the role store is a read-write store, such as the default ArcGIS Server store. If the role you attempt to add has a name that matches a role that already exists in the role store, an error will be returned.
Request parameters
| Parameter | Details | 
|---|---|
  | The name of the role. The name must be unique in the role store. Example  | 
  | An optional field to add comments or a description for the role. Example  | 
  | The response format. The default response format is  Values:   | 
Example usage
The following is a sample POST request for the add operation:
POST /webadaptor/admin/security/roles/add HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
rolename=editors&description=Group of users that can edit maps&f=pjsonJSON Response example
{"status": "success"}