<h1>POST api/reportserver/v2/userroles</h1>
<div>
<p>
Creates a new user role.
</p>

<h2>Request Information</h2>

<h3>URI Parameters</h3>
<p>None.</p>

<h3>Body Parameters</h3>

<p>User role model.</p>

<a href="/implementer-guide/apis/rest-api/v2/createuserroledata">CreateUserRoleData</a>

<table class="help-page-table">
<thead>
<tr><th>Name</th><th>Description</th><th>Type</th><th>Additional information</th></tr>
</thead>
<tbody>
<tr>
<td class="parameter-name">Name</td>
<td class="parameter-documentation">
<p>
Specifies the name of the user role.
</p>
</td>
<td class="parameter-type">
string

</td>
<td class="parameter-annotations">
<p>Required</p>
</td>
</tr>
<tr>
<td class="parameter-name">Description</td>
<td class="parameter-documentation">
<p>
Specifies the description of the user role.
</p>
</td>
<td class="parameter-type">
string

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">UserIds</td>
<td class="parameter-documentation">
<p>
The IDs of the assigned to the role users.
</p>
</td>
<td class="parameter-type">
Collection of string

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
</tbody>
</table>
<h3>Request body formats</h3>
<div>
<h4 class="sample-header">application/json, text/json</h4>
<div class="sample-content">

```json
{
  "Name": "Financial Reports",
  "Description": "A short, descriptive summary shown to users in the Report Server UI.",
  "UserIds": [
    "3eba0826af2a45a3a06cc85706fda9da",
    "832060d465e8423ebea50070bb0a13e6"
  ]
}
```

</div>
</div>

<h2>Response Information</h2>

<h3>Resource Description</h3>

<p></p>

<a href="/implementer-guide/apis/rest-api/v2/userrole">UserRole</a>

<table class="help-page-table">
<thead>
<tr><th>Name</th><th>Description</th><th>Type</th><th>Additional information</th></tr>
</thead>
<tbody>
<tr>
<td class="parameter-name">Id</td>
<td class="parameter-documentation">
<p>
Specifies the role identifier.
</p>
</td>
<td class="parameter-type">
string

</td>
<td class="parameter-annotations">
<p>Required</p>
</td>
</tr>
<tr>
<td class="parameter-name">Name</td>
<td class="parameter-documentation">
<p>
Specifies the user role name.
</p>
</td>
<td class="parameter-type">
string

</td>
<td class="parameter-annotations">
<p>Required</p>
</td>
</tr>
<tr>
<td class="parameter-name">Description</td>
<td class="parameter-documentation">
<p>
Specifies the description of the user role.
</p>
</td>
<td class="parameter-type">
string

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">IsSystemRole</td>
<td class="parameter-documentation">
<p>
Indicates whether the user role is a system role or not.
</p>
</td>
<td class="parameter-type">
boolean

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
<tr>
<td class="parameter-name">UserIds</td>
<td class="parameter-documentation">
<p>
Returns a list of IDs of users that are assigned to the role.
</p>
</td>
<td class="parameter-type">
Collection of string

</td>
<td class="parameter-annotations">
<p>None.</p>
</td>
</tr>
</tbody>
</table>

<h3>Response Formats</h3>
<div>
<h4 class="sample-header">application/json, text/json</h4>
<div class="sample-content">

```json
{
  "Id": "2ac769584f1",
  "Name": "Financial Reports",
  "Description": "A short, descriptive summary shown to users in the Report Server UI.",
  "IsSystemRole": true,
  "UserIds": [
    "3eba0826af2a45a3a06cc85706fda9da",
    "832060d465e8423ebea50070bb0a13e6"
  ]
}
```

</div>
</div>
</div>
