# Get role

`GET /v1/roles/{role}`, operation `roles.GetRole`

Gets a role.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `role` | path | Yes | `string` | The role's ID, such as agents.user for roles/agents.user. |

## Responses

### 200

OK

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `description` | `string` | Yes | What the role is for. |
| `grantableOn` | `string[]` | Yes | The types of resource the role can be granted on, such as resourcemanager.kosem.ai/Project: those with IAM policies that the role names, on each of which a permission of the role's own service holds, or all of them for a basic role. |
| `includedPermissions` | `string[]` | Yes | The permissions the role grants, such as agents.agents.create. Each holds where the role is granted and on the resources below it of the type the permission is checked on. |
| `name` | `string` | Yes | Resource name, such as roles/agents.user, by which IAM policies grant the role. |
| `title` | `string` | Yes | Name shown in user interfaces, such as Agents User. |

### default

Error

Base URL: `https://api.kosem.ai`. See [API conventions](https://docs.kosem.ai/reference/api-conventions.md) for authentication, pagination and errors, and [https://docs.kosem.ai/openapi.yaml](https://docs.kosem.ai/openapi.yaml) for the full OpenAPI document.