{
"id": "wh_evt_67aa128c2f4a",
"event": "user_role.updated",
"api_version": "2024-01",
"created": 1735689600,
"tenant_id": 1,
"request": {
"id": "req_8c2f4a67aa12"
},
"object": {
"@id": "/api/v1/user_roles/199",
"id": 199,
"validityEndDate": "2027-01-15"
},
"previous_attributes": {
"validityEndDate": null
},
"is_update": true,
"entity_type": "user_role",
"operation": "updated"
}Webhooks
Role assignment updated
Fires when a role assignment’s properties change (scope adjustment, validity dates, custom attributes). The role itself is immutable — to “change a role”, delete the old assignment and create a new one.
WEBHOOK
user_role.updated
{
"id": "wh_evt_67aa128c2f4a",
"event": "user_role.updated",
"api_version": "2024-01",
"created": 1735689600,
"tenant_id": 1,
"request": {
"id": "req_8c2f4a67aa12"
},
"object": {
"@id": "/api/v1/user_roles/199",
"id": 199,
"validityEndDate": "2027-01-15"
},
"previous_attributes": {
"validityEndDate": null
},
"is_update": true,
"entity_type": "user_role",
"operation": "updated"
}Authorizations
ApiTokenJWT
Server-to-server authentication. Generate a token in the admin UI at
Settings → Developers → API Access. Send the raw token in the
Api-Token header — there is no Bearer prefix.
Tokens can be marked read-only at creation time, in which case the API
rejects any non-GET request with 403 Forbidden.
Body
application/json
Response
Acknowledged. Any 2xx tells Orgo the delivery succeeded.

