# Role

Represents a role in YouTrack.

Available since YouTrack 2026.1.

## Attributes

This table describes attributes of the `Role` entity.

* To receive an attribute in the response from the server, specify it explicitly in the `fields` request parameter.

* To update an attribute, provide it in the body of a POST request.

|  Field  |  Type  |  Description  |
| --- | --- | --- |
|  id  |  String  |  The database ID of the role. `Read-only`.  |
|  name  |  String  |  The name of the role.  |
|  description  |  String  |  The description of the role. `Can be null`.  |
|  permissions  |  [Array of Permissions](api-entity-Permission.html)  |  The list of permissions included in the role. `Read-only`.  |
|  immutable  |  Boolean  |  True if the role is immutable, otherwise false. Immutable roles cannot be updated or deleted. `Read-only`.  |