Update a specific On-Call Role by id
curl --request PUT \
--url https://api.rootly.com/v1/on_call_roles/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "on_call_roles",
"attributes": {
"name": "<string>",
"slug": "<string>",
"system_role": "custom",
"alert_sources_permissions": [
"create"
],
"alert_urgency_permissions": [
"create"
],
"alerts_permissions": [
"create"
],
"api_keys_permissions": [
"create"
],
"audits_permissions": [
"create"
],
"contacts_permissions": [
"read"
],
"escalation_policies_permissions": [
"create"
],
"groups_permissions": [
"create"
],
"heartbeats_permissions": [
"create"
],
"integrations_permissions": [
"create"
],
"invitations_permissions": [
"create"
],
"live_call_routing_permissions": [
"create"
],
"schedule_override_permissions": [
"create"
],
"schedules_permissions": [
"create"
],
"services_permissions": [
"create"
],
"webhooks_permissions": [
"create"
],
"workflows_permissions": [
"create"
]
}
}
}'{
"data": {
"id": "53db475a-4509-4d6a-91f7-e1538f2260eb",
"type": "on_call_roles",
"attributes": {
"team_id": 368,
"name": "Security",
"slug": "on-call-role-13",
"system_role": "custom",
"alert_sources_permissions": [],
"alert_urgency_permissions": [],
"alerts_permissions": [],
"api_keys_permissions": [],
"audits_permissions": [],
"contacts_permissions": [],
"escalation_policies_permissions": [],
"groups_permissions": [],
"heartbeats_permissions": [],
"integrations_permissions": [],
"invitations_permissions": [],
"live_call_routing_permissions": [],
"schedule_override_permissions": [],
"schedules_permissions": [],
"services_permissions": [],
"webhooks_permissions": [],
"workflows_permissions": [],
"updated_at": "2025-11-26T20:56:09.288-08:00",
"created_at": "2025-11-26T20:56:09.105-08:00"
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Show child attributes
on_call_roles Show child attributes
The role name.
The role slug.
The kind of role (user and custom type roles are only editable)
create, read, update, delete create, read, update, delete create, update, read create, read, update, delete create, read, update, delete read create, read, update, delete create, read, update, delete create, read, update, delete create, read, update, delete create, read, update, delete create, read, update, delete create, update create, read, update, delete create, read, update, delete create, read, update, delete create, read, update, delete on_call_role updated
Show child attributes
Unique ID of the on_call_role
on_call_roles Show child attributes
The role name.
The role slug.
The kind of role
create, read, update, delete create, read, update, delete create, update, read create, read, update, delete create, read, update, delete read create, read, update, delete create, read, update, delete create, read, update, delete create, read, update, delete create, read, update, delete create, read, update, delete create, update create, read, update, delete create, read, update, delete create, read, update, delete create, read, update, delete Was this page helpful?
curl --request PUT \
--url https://api.rootly.com/v1/on_call_roles/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '{
"data": {
"type": "on_call_roles",
"attributes": {
"name": "<string>",
"slug": "<string>",
"system_role": "custom",
"alert_sources_permissions": [
"create"
],
"alert_urgency_permissions": [
"create"
],
"alerts_permissions": [
"create"
],
"api_keys_permissions": [
"create"
],
"audits_permissions": [
"create"
],
"contacts_permissions": [
"read"
],
"escalation_policies_permissions": [
"create"
],
"groups_permissions": [
"create"
],
"heartbeats_permissions": [
"create"
],
"integrations_permissions": [
"create"
],
"invitations_permissions": [
"create"
],
"live_call_routing_permissions": [
"create"
],
"schedule_override_permissions": [
"create"
],
"schedules_permissions": [
"create"
],
"services_permissions": [
"create"
],
"webhooks_permissions": [
"create"
],
"workflows_permissions": [
"create"
]
}
}
}'{
"data": {
"id": "53db475a-4509-4d6a-91f7-e1538f2260eb",
"type": "on_call_roles",
"attributes": {
"team_id": 368,
"name": "Security",
"slug": "on-call-role-13",
"system_role": "custom",
"alert_sources_permissions": [],
"alert_urgency_permissions": [],
"alerts_permissions": [],
"api_keys_permissions": [],
"audits_permissions": [],
"contacts_permissions": [],
"escalation_policies_permissions": [],
"groups_permissions": [],
"heartbeats_permissions": [],
"integrations_permissions": [],
"invitations_permissions": [],
"live_call_routing_permissions": [],
"schedule_override_permissions": [],
"schedules_permissions": [],
"services_permissions": [],
"webhooks_permissions": [],
"workflows_permissions": [],
"updated_at": "2025-11-26T20:56:09.288-08:00",
"created_at": "2025-11-26T20:56:09.105-08:00"
}
}
}