Delete a specific role by id
curl --request DELETE \
--url https://api.rootly.com/v1/roles/{id} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "7d027650-9202-41f2-9e2f-24482173463e",
"type": "roles",
"attributes": {
"team_id": 440,
"name": "Role 15",
"slug": "role-15",
"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": "2f11ecae-66f0-49fc-9baf-2d7512a95758",
"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-10T18:29:28.480-08:00",
"created_at": "2025-12-10T18:29:28.387-08:00"
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Resource UUID
role deleted
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 DELETE \
--url https://api.rootly.com/v1/roles/{id} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "7d027650-9202-41f2-9e2f-24482173463e",
"type": "roles",
"attributes": {
"team_id": 440,
"name": "Role 15",
"slug": "role-15",
"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": "2f11ecae-66f0-49fc-9baf-2d7512a95758",
"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-10T18:29:28.480-08:00",
"created_at": "2025-12-10T18:29:28.387-08:00"
}
}
}