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.
- Go to Organization > Connectors and find Rootly. Click Enable, and choose which tools to allow.
- Create an OAuth application in the Rootly developer portal.
- Add the Redirect URI shown in the connector settings to the application.
- Copy the application's Client ID and Client Secret into the connector, then save it.
- 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:readir.environments:writeir.functionalities:readir.functionalities:writeir.groups:readir.groups:writeir.incident_types:readir.incidents:readir.incidents:writeir.services:readir.services:writeir.severities:readir.workflows:readir.workflows:writeoc.alerts:readoc.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.
| Tool | What it does |
|---|---|
get_alert | Get details about a specific alert by ID. |
get_current_user | Get information about the currently authenticated user. |
get_environment | Get details about a specific environment by ID. |
get_functionality | Get details about a specific functionality by ID. |
get_incident | Get details about a specific incident by ID. |
get_service | Get details about a specific service by ID. |
get_team | Get details about a specific team by ID. |
get_user | Get details about a specific user by ID. |
get_workflow | Get details about a specific workflow by ID. |
list_alerts | List alerts, optionally filtered by status, source, service, environment, team or label. |
list_environments | Get a list of environments with optional filtering by name. |
list_functionalities | Get a list of functionalities with optional filtering by name or services. |
list_incident_action_items | Get all follow-up action items for an incident. |
list_incident_types | List the incident types configured in this workspace. |
list_incidents | Get a list of incidents with optional filtering by status, severity, services, or environments. |
list_services | Get a list of services with optional filtering by name. |
list_severities | List the severity levels configured in this workspace. |
list_teams | Get a list of teams with optional filtering by name. |
list_users | Get a list of users with optional filtering by email or role. |
list_workflows | Get a list of workflows with optional filtering by name or enabled status. |
validate_credential | Validate Rootly API credentials by checking access to the current user endpoint. |
Write (8)
Create or send data.
| Tool | What it does |
|---|---|
create_alert | Create a new alert. |
create_environment | Create a new environment. |
create_functionality | Create a new functionality. |
create_incident | Create a new incident. |
create_incident_action_item | Create a follow-up action item for an incident. |
create_service | Create a new service. |
create_team | Create a new team. |
create_workflow | Create a new workflow. |
Delete or overwrite (17)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_alert | Permanently delete an alert by ID. |
delete_environment | Permanently delete an environment. |
delete_functionality | Permanently delete a functionality. |
delete_incident | Permanently delete an incident. |
delete_service | Permanently delete a service. |
delete_team | Permanently delete a team. |
delete_workflow | Permanently delete a workflow. |
mitigate_incident | Mark an incident as mitigated with optional mitigation summary. |
resolve_incident | Mark an incident as resolved with optional resolution summary and root cause. |
update_alert | Update an alert's summary, description, noise flag, labels or associations. |
update_environment | Update an environment's name, description, or notification settings. |
update_functionality | Update a functionality's name, description, notifications, or services. |
update_incident | Update an incident's title, status, severity, or associations. |
update_service | Update a service's name, description, or notification settings. |
update_team | Update a team's name, description, or notification settings. |
update_user | Update a user's first name, last name, role, or on-call role. |
update_workflow | Update 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. |