# Roles requests

> Reference for roles API endpoints, including retrieving role details by ID and auto-provisioned user assignments

## Retrieving info about a specific role according to its ID

This endpoint helps you retrieve details about a particular role based on its ID.

:::note
This endpoint only returns folders and roles explicitly set for an auto-provisioned user. The ones inherited from the group configuration can be retrieved through the `/api/DirectoryService/GetDirectoryPermissions?userId={userId}` endpoint.
:::

GET

`https://{yourDomain}/{organizationName}/{tenantName}/orchestrator_/odata/Roles(259)`

### Request headers

| Header | Value |
| --- | --- |
| Authorization | Bearer |

### Request body

```
{
    "@odata.context": "https://{yourDomain}/{organizationName}/{tenantName}/orchestrator_/odata/$metadata#Roles/$entity",
    "Name": "TestRole",
    "DisplayName": "TestRole",
    "Groups": null,
    "IsStatic": false,
    "IsEditable": true,
    "Id": 259
}
```

### Response code

200 OK