role.* events
Role create, update and delete.
Role create, update and delete. Creating and updating a role are Growth-tier capabilities; deleting is not.
| Event | Fires when |
|---|---|
role.created | A new role is created within a team. |
role.updated | Role name or abilities change. |
role.deleted | A role that no collaborator currently holds is deleted. |
Example envelope
{
"id": "evt_01HX...",
"type": "role.updated",
"created_at": "2026-05-18T10:05:00Z",
"api_version": "2026-05-01",
"project_id": null,
"data": {
"team_id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86",
"role_id": "d05e1a83-7c46-4f29-b613-8ae407c9d251",
"code": "plan-editor",
"name": "Plan Editor"
}
}project_id is always null for role.* events; these are account-level.
Required ability
Tokens subscribing to role.* events must carry role:view at mint time.
Events
role.created
A new role is created within a team.
role.updated
A role's name or abilities change.
role.deleted
A role is deleted. Only roles no collaborator currently holds can be deleted.
Compare with the current pages
How is this guide?