role.* events
Role creation, edits and deletion.
Role creation, edits and deletion. A role is the permission set one member holds on a team; every team starts with the eight default roles and admins add their own. These are account-level events: project_id is always null.
Background
Example envelope
{
"id": "evt_01K8QD4N3M7Y2K4N6P9R1T3V80",
"type": "role.created",
"created_at": "2026-11-01T09:00:00+00:00",
"api_version": "2026-11-01",
"project_id": null,
"data": {
"code": "support_agent",
"name": "Support Agent",
"permissions": ["ticket:view-any", "ticket:view", "ticket:respond"],
"role_id": "d05e1a83-7c46-4f29-b613-8ae407c9d251",
"team_id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86"
}
}Required ability
Tokens subscribing to role.* events need role:view at mint time.
Events
How is this guide?
Last updated on