# Role events

> For the complete documentation index, see [llms.txt](https://doc.ibexa.co/en/5.0/llms.txt).

Events that are triggered when working with roles.

| Event                         | Dispatched by                   | Properties                                                                                 |
| ----------------------------- | ------------------------------- | ------------------------------------------------------------------------------------------ |
| `BeforeCreateRoleDraftEvent`  | `RoleService::createRoleDraft`  | `Role $role` `?RoleDraft $roleDraft`                                                       |
| `CreateRoleDraftEvent`        | `RoleService::createRoleDraft`  | `Role $role` `RoleDraft $roleDraft`                                                        |
| `BeforeCreateRoleEvent`       | `RoleService::createRole`       | `RoleCreateStruct $roleCreateStruct` `?RoleDraft $roleDraft`                               |
| `CreateRoleEvent`             | `RoleService::createRole`       | `RoleCreateStruct $roleCreateStruct` `RoleDraft $roleDraft`                                |
| `BeforeUpdateRoleDraftEvent`  | `RoleService::updateRoleDraft`  | `RoleDraft $roleDraft` `RoleUpdateStruct $roleUpdateStruct` `?RoleDraft $updatedRoleDraft` |
| `UpdateRoleDraftEvent`        | `RoleService::updateRoleDraft`  | `RoleDraft $roleDraft` `RoleUpdateStruct $roleUpdateStruct` `RoleDraft $updatedRoleDraft`  |
| `BeforeCopyRoleEvent`         | `RoleService::copyRole`         | `Role $role` `RoleCopyStruct $roleCopyStruct` `?Role $copiedRole`                          |
| `CopyRoleEvent`               | `RoleService::copyRole`         | `Role $copiedRole` `Role $role` `RoleCopyStruct $roleCopyStruct`                           |
| `BeforePublishRoleDraftEvent` | `RoleService::publishRoleDraft` | `RoleDraft $roleDraft`                                                                     |
| `PublishRoleDraftEvent`       | `RoleService::publishRoleDraft` | `RoleDraft $roleDraft`                                                                     |
| `BeforeDeleteRoleDraftEvent`  | `RoleService::deleteRoleDraft`  | `RoleDraft $roleDraft`                                                                     |
| `DeleteRoleDraftEvent`        | `RoleService::deleteRoleDraft`  | `RoleDraft $roleDraft`                                                                     |
| `BeforeDeleteRoleEvent`       | `RoleService::deleteRole`       | `Role $role`                                                                               |
| `DeleteRoleEvent`             | `RoleService::deleteRole`       | `Role $role`                                                                               |

## Adding policies

| Event                                | Dispatched by                          | Properties                                                                                                               |
| ------------------------------------ | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `BeforeAddPolicyByRoleDraftEvent`    | `RoleService::addPolicyByRoleDraft`    | `RoleDraft $roleDraft` `PolicyCreateStruct $policyCreateStruct` `?RoleDraft $updatedRoleDraft`                           |
| `AddPolicyByRoleDraftEvent`          | `RoleService::addPolicyByRoleDraft`    | `RoleDraft $roleDraft` `PolicyCreateStruct $policyCreateStruct` `private $updatedRoleDraft`                              |
| `BeforeUpdatePolicyByRoleDraftEvent` | `RoleService::updatePolicyByRoleDraft` | `RoleDraft $roleDraft` `PolicyDraft $policy` `PolicyUpdateStruct $policyUpdateStruct` `?PolicyDraft $updatedPolicyDraft` |
| `UpdatePolicyByRoleDraftEvent`       | `RoleService::updatePolicyByRoleDraft` | `RoleDraft $roleDraft` `PolicyDraft $policy` `PolicyUpdateStruct $policyUpdateStruct` `PolicyDraft $updatedPolicyDraft`  |
| `BeforeRemovePolicyByRoleDraftEvent` | `RoleService::removePolicyByRoleDraft` | `RoleDraft $roleDraft` `PolicyDraft $policyDraft` `?RoleDraft $updatedRoleDraft`                                         |
| `RemovePolicyByRoleDraftEvent`       | `RoleService::removePolicyByRoleDraft` | `RoleDraft $roleDraft` `PolicyDraft $policyDraft` `RoleDraft $updatedRoleDraft`                                          |

## Assigning roles

| Event                              | Dispatched by                        | Properties                                                                      |
| ---------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------- |
| `BeforeAssignRoleToUserEvent`      | `RoleService::assignRoleToUser`      | `Role $role` `User $user` `Limitation\RoleLimitation $roleLimitation`           |
| `AssignRoleToUserEvent`            | `RoleService::assignRoleToUser`      | `Role $role` `User $user` `Limitation\RoleLimitation $roleLimitation`           |
| `BeforeAssignRoleToUserGroupEvent` | `RoleService::assignRoleToUserGroup` | `Role $role` `UserGroup $userGroup` `Limitation\RoleLimitation $roleLimitation` |
| `AssignRoleToUserGroupEvent`       | `RoleService::assignRoleToUserGroup` | `Role $role` `UserGroup $userGroup` `Limitation\RoleLimitation $roleLimitation` |
| `BeforeRemoveRoleAssignmentEvent`  | `RoleService::removeRoleAssignment`  | `RoleAssignment $roleAssignment`                                                |
| `RemoveRoleAssignmentEvent`        | `RoleService::removeRoleAssignment`  | `RoleAssignment $roleAssignment`                                                |