# Roles

## List Roles API

 - [GET /authz2/v1/roles/](https://develop-api.esper.io/openapi/roles/getroleurl.md): API to retrieve all the roles for the tenant

## Create a new role. Then optionally add scopes by using the Update Role Scopes API. No scopes are added by default.

 - [POST /authz2/v1/roles/](https://develop-api.esper.io/openapi/roles/postroleurl.md): Learn more about Creating Custom Roles.

## Get Role API

 - [GET /authz2/v1/roles/{role_id}](https://develop-api.esper.io/openapi/roles/getroleidurl.md): API to retrieve the role for the tenant

## Patch Role API

 - [PATCH /authz2/v1/roles/{role_id}](https://develop-api.esper.io/openapi/roles/updateroleidurl.md): API to update role details

## Delete Role API

 - [DELETE /authz2/v1/roles/{role_id}](https://develop-api.esper.io/openapi/roles/deleteroleidurl.md): API to delete the role for the tenant

## Update Role Scopes API

 - [PUT /authz2/v1/roles/{role_id}/scopes](https://develop-api.esper.io/openapi/roles/putrolescopeurl.md): API to update scopes of an roles for the tenant

## List Role Scopes API

 - [GET /authz2/v1/roles/{role_id}/scopes](https://develop-api.esper.io/openapi/roles/getrolescopeurl.md): API to retrieve scopes of an roles for the tenant