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": "25b67200-fc91-4fba-aa45-6041d281db8a",
"type": "roles",
"attributes": {
"team_id": 355,
"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": "553c391a-3c47-478f-a568-fcad59c83e1f",
"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-07-24T00:11:59.190-07:00",
"created_at": "2025-07-24T00:11:59.025-07:00"
}
}
}
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
role updated
The response is of type object
.
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": "25b67200-fc91-4fba-aa45-6041d281db8a",
"type": "roles",
"attributes": {
"team_id": 355,
"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": "553c391a-3c47-478f-a568-fcad59c83e1f",
"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-07-24T00:11:59.190-07:00",
"created_at": "2025-07-24T00:11:59.025-07:00"
}
}
}