# Roles

All Roles related paths.

 - [GET /roles](https://docs.upvest.co/api/roles/list_roles.md): Returns a paginated list of roles. Use the `offset` and `limit` query parameters to page through results; `meta.total_count` gives the total number of matching roles. Use `user_id` to filter by a spec
 - [POST /roles](https://docs.upvest.co/api/roles/create_role.md): Creates a role, assigning a user to an account group or business entity. The `entity_type` parameter determines whether `entity_id` refers to an account group or a business, and constrains which `role
 - [GET /roles/{role_id}](https://docs.upvest.co/api/roles/retrieve_role.md): Returns the role identified by `role_id`, including its status and entity assignment.
 - [DELETE /roles/{role_id}](https://docs.upvest.co/api/roles/role_deactivation.md): Deactivates the role specified by its ID. The role remains queryable with status `DEACTIVATED`. Only roles whose `entity_type` is `BUSINESS` may be deactivated via this endpoint; account-group roles a
 - [POST Role events](https://docs.upvest.co/api/roles/role_event.md): Notifies subscribers of role lifecycle events. Triggered when a role is created, activated, or deactivated. When an account group is created for a user, Upvest creates a role for that user automatical