- 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 /<context>/admin/security/roles/add HTTP/1.1
Host: organization.example.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"}