role.* events
Role create, update and delete.
Role create, update and delete. Creating and updating a role are Growth-tier capabilities; deleting is not.
Background
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
How is this guide?
Last updated on