Skip to main content

Rootly

Comprehensive Rootly connector for incident management, response operations, service monitoring, team coordination, alert management, and workflow automation.

Categories: Incident Management, DevOps, Monitoring, Collaboration

What you can ask​

  • List active incidents and the on-call for each.
  • Open an incident with severity SEV2 for the API outage and page the on-call.
  • Pull the post-mortem for the most recent SEV1.

Set up​

Rootly needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Rootly. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Rootly developer portal.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Rootly login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (16)

Grant the scopes for the tools you plan to allow.

  • ir.environments:read
  • ir.environments:write
  • ir.functionalities:read
  • ir.functionalities:write
  • ir.groups:read
  • ir.groups:write
  • ir.incident_types:read
  • ir.incidents:read
  • ir.incidents:write
  • ir.services:read
  • ir.services:write
  • ir.severities:read
  • ir.workflows:read
  • ir.workflows:write
  • oc.alerts:read
  • oc.alerts:write

Tools​

Rootly offers 46 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (21)​

View and search information without changing it.

ToolWhat it does
get_alertGet details about a specific alert by ID.
get_current_userGet information about the currently authenticated user.
get_environmentGet details about a specific environment by ID.
get_functionalityGet details about a specific functionality by ID.
get_incidentGet details about a specific incident by ID.
get_serviceGet details about a specific service by ID.
get_teamGet details about a specific team by ID.
get_userGet details about a specific user by ID.
get_workflowGet details about a specific workflow by ID.
list_alertsList alerts, optionally filtered by status, source, service, environment, team or label.
list_environmentsGet a list of environments with optional filtering by name.
list_functionalitiesGet a list of functionalities with optional filtering by name or services.
list_incident_action_itemsGet all follow-up action items for an incident.
list_incident_typesList the incident types configured in this workspace.
list_incidentsGet a list of incidents with optional filtering by status, severity, services, or environments.
list_servicesGet a list of services with optional filtering by name.
list_severitiesList the severity levels configured in this workspace.
list_teamsGet a list of teams with optional filtering by name.
list_usersGet a list of users with optional filtering by email or role.
list_workflowsGet a list of workflows with optional filtering by name or enabled status.
validate_credentialValidate Rootly API credentials by checking access to the current user endpoint.

Write (8)​

Create or send data.

ToolWhat it does
create_alertCreate a new alert.
create_environmentCreate a new environment.
create_functionalityCreate a new functionality.
create_incidentCreate a new incident.
create_incident_action_itemCreate a follow-up action item for an incident.
create_serviceCreate a new service.
create_teamCreate a new team.
create_workflowCreate a new workflow.

Delete or overwrite (17)​

Remove or replace existing data.

ToolWhat it does
delete_alertPermanently delete an alert by ID.
delete_environmentPermanently delete an environment.
delete_functionalityPermanently delete a functionality.
delete_incidentPermanently delete an incident.
delete_servicePermanently delete a service.
delete_teamPermanently delete a team.
delete_workflowPermanently delete a workflow.
mitigate_incidentMark an incident as mitigated with optional mitigation summary.
resolve_incidentMark an incident as resolved with optional resolution summary and root cause.
update_alertUpdate an alert's summary, description, noise flag, labels or associations.
update_environmentUpdate an environment's name, description, or notification settings.
update_functionalityUpdate a functionality's name, description, notifications, or services.
update_incidentUpdate an incident's title, status, severity, or associations.
update_serviceUpdate a service's name, description, or notification settings.
update_teamUpdate a team's name, description, or notification settings.
update_userUpdate a user's first name, last name, role, or on-call role.
update_workflowUpdate any attribute of a workflow: name, description, enabled, trigger_params, priority, workflow_group_id, or the environment, service, functionality, team, severity and incident type IDs it is scoped to.
⌘J