Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Resource UUID
Response
role deleted
Delete a specific role by id
curl --request DELETE \
--url https://api.rootly.com/v1/roles/{id} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "1f8e8bff-ef6b-4a95-9dfc-19e1914b2a72",
"type": "roles",
"attributes": {
"team_id": 425,
"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": "5db3e3af-5a3e-41f8-a661-3fc650ab631a",
"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-11-17T20:26:19.193-08:00",
"created_at": "2025-11-17T20:26:19.073-08:00"
}
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Resource UUID
role deleted
Show child attributes
Was this page helpful?
curl --request DELETE \
--url https://api.rootly.com/v1/roles/{id} \
--header 'Authorization: Bearer <token>'{
"data": {
"id": "1f8e8bff-ef6b-4a95-9dfc-19e1914b2a72",
"type": "roles",
"attributes": {
"team_id": 425,
"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": "5db3e3af-5a3e-41f8-a661-3fc650ab631a",
"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-11-17T20:26:19.193-08:00",
"created_at": "2025-11-17T20:26:19.073-08:00"
}
}
}