Update a specific role by id
curl --request PUT \
--url https://api.rootly.com/v1/roles/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "roles",
"attributes": {
"name": "<string>",
"slug": "<string>",
"incident_permission_set_id": "<string>",
"api_keys_permissions": [
"create"
],
"audits_permissions": [
"create"
],
"billing_permissions": [
"create"
],
"environments_permissions": [
"create"
],
"form_fields_permissions": [
"create"
],
"functionalities_permissions": [
"create"
],
"groups_permissions": [
"create"
],
"incident_causes_permissions": [
"create"
],
"incident_feedbacks_permissions": [
"create"
],
"incident_roles_permissions": [
"create"
],
"incident_types_permissions": [
"create"
],
"incidents_permissions": [
"create"
],
"integrations_permissions": [
"create"
],
"invitations_permissions": [
"create"
],
"playbooks_permissions": [
"create"
],
"private_incidents_permissions": [
"create"
],
"retrospective_permissions": [
"create"
],
"roles_permissions": [
"create"
],
"secrets_permissions": [
"create"
],
"services_permissions": [
"create"
],
"severities_permissions": [
"create"
],
"status_pages_permissions": [
"create"
],
"webhooks_permissions": [
"create"
],
"workflows_permissions": [
"create"
]
}
}
}
'{
"data": {
"id": "bf319963-dc30-4137-8d3a-8fa730058a42",
"type": "roles",
"attributes": {
"team_id": 440,
"name": "Security",
"slug": "role-13",
"is_deletable": true,
"is_editable": true,
"alerts_permissions": [
"create",
"read"
],
"api_keys_permissions": [
"read"
],
"audits_permissions": [],
"billing_permissions": [
"update"
],
"environments_permissions": [
"read"
],
"form_fields_permissions": [
"read"
],
"functionalities_permissions": [
"read"
],
"groups_permissions": [
"read"
],
"incident_causes_permissions": [
"read"
],
"incident_feedbacks_permissions": [
"read",
"create",
"update"
],
"incident_permission_set_id": "fe8fe220-f0f8-49a6-bf99-e8ee8ae33bd8",
"incident_roles_permissions": [
"read"
],
"incident_types_permissions": [
"read"
],
"incidents_permissions": [
"read"
],
"integrations_permissions": [],
"invitations_permissions": [
"read"
],
"playbooks_permissions": [
"read"
],
"private_incidents_permissions": [],
"pulses_permissions": [
"create",
"update",
"read"
],
"retrospective_permissions": [
"read"
],
"roles_permissions": [
"read"
],
"secrets_permissions": [
"create"
],
"services_permissions": [
"read"
],
"severities_permissions": [
"read"
],
"status_pages_permissions": [
"read"
],
"webhooks_permissions": [
"read"
],
"workflows_permissions": [
"read"
],
"updated_at": "2025-12-13T18:52:03.757-08:00",
"created_at": "2025-12-13T18:52:03.685-08:00"
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Resource UUID
Show child attributes
roles Show child attributes
The role name.
The role slug.
Associated incident permissions set.
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, read, update, delete 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, read, update, delete 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, read, update, delete create, read, update, delete create, read, update, delete create, read, update, delete role updated
Show child attributes
Unique ID of the role
roles Show child attributes
The role name.
The role slug.
Associated incident permissions set.
Whether the role can be deleted.
Whether the role can be edited.
create, 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, read, update, delete 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, read, update, delete create, read, update, delete create, read, update, delete create, update, 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, read, update, delete create, read, update, delete Was this page helpful?
curl --request PUT \
--url https://api.rootly.com/v1/roles/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/vnd.api+json' \
--data '
{
"data": {
"type": "roles",
"attributes": {
"name": "<string>",
"slug": "<string>",
"incident_permission_set_id": "<string>",
"api_keys_permissions": [
"create"
],
"audits_permissions": [
"create"
],
"billing_permissions": [
"create"
],
"environments_permissions": [
"create"
],
"form_fields_permissions": [
"create"
],
"functionalities_permissions": [
"create"
],
"groups_permissions": [
"create"
],
"incident_causes_permissions": [
"create"
],
"incident_feedbacks_permissions": [
"create"
],
"incident_roles_permissions": [
"create"
],
"incident_types_permissions": [
"create"
],
"incidents_permissions": [
"create"
],
"integrations_permissions": [
"create"
],
"invitations_permissions": [
"create"
],
"playbooks_permissions": [
"create"
],
"private_incidents_permissions": [
"create"
],
"retrospective_permissions": [
"create"
],
"roles_permissions": [
"create"
],
"secrets_permissions": [
"create"
],
"services_permissions": [
"create"
],
"severities_permissions": [
"create"
],
"status_pages_permissions": [
"create"
],
"webhooks_permissions": [
"create"
],
"workflows_permissions": [
"create"
]
}
}
}
'{
"data": {
"id": "bf319963-dc30-4137-8d3a-8fa730058a42",
"type": "roles",
"attributes": {
"team_id": 440,
"name": "Security",
"slug": "role-13",
"is_deletable": true,
"is_editable": true,
"alerts_permissions": [
"create",
"read"
],
"api_keys_permissions": [
"read"
],
"audits_permissions": [],
"billing_permissions": [
"update"
],
"environments_permissions": [
"read"
],
"form_fields_permissions": [
"read"
],
"functionalities_permissions": [
"read"
],
"groups_permissions": [
"read"
],
"incident_causes_permissions": [
"read"
],
"incident_feedbacks_permissions": [
"read",
"create",
"update"
],
"incident_permission_set_id": "fe8fe220-f0f8-49a6-bf99-e8ee8ae33bd8",
"incident_roles_permissions": [
"read"
],
"incident_types_permissions": [
"read"
],
"incidents_permissions": [
"read"
],
"integrations_permissions": [],
"invitations_permissions": [
"read"
],
"playbooks_permissions": [
"read"
],
"private_incidents_permissions": [],
"pulses_permissions": [
"create",
"update",
"read"
],
"retrospective_permissions": [
"read"
],
"roles_permissions": [
"read"
],
"secrets_permissions": [
"create"
],
"services_permissions": [
"read"
],
"severities_permissions": [
"read"
],
"status_pages_permissions": [
"read"
],
"webhooks_permissions": [
"read"
],
"workflows_permissions": [
"read"
],
"updated_at": "2025-12-13T18:52:03.757-08:00",
"created_at": "2025-12-13T18:52:03.685-08:00"
}
}
}