Retrieves a specific role by id
curl --request GET \
--url https://api.rootly.com/v1/roles/{id} \
--header 'Authorization: Bearer <token>'
{
"data": {
"id": "1a2e6db5-8d60-42ba-9ebc-d45dc64119e0",
"type": "roles",
"attributes": {
"team_id": 351,
"name": "Role 11",
"slug": "role-11",
"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": "d08abab3-6120-4620-8cb6-37490857409f",
"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-05T07:47:36.127-07:00",
"created_at": "2025-07-05T07:47:36.127-07:00"
}
}
}
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
role found
The response is of type object
.
Was this page helpful?
curl --request GET \
--url https://api.rootly.com/v1/roles/{id} \
--header 'Authorization: Bearer <token>'
{
"data": {
"id": "1a2e6db5-8d60-42ba-9ebc-d45dc64119e0",
"type": "roles",
"attributes": {
"team_id": 351,
"name": "Role 11",
"slug": "role-11",
"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": "d08abab3-6120-4620-8cb6-37490857409f",
"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-05T07:47:36.127-07:00",
"created_at": "2025-07-05T07:47:36.127-07:00"
}
}
}