Rootly

Manage incidents, alerts, and on-call with Rootly

Rootly is an incident management platform that helps teams respond to, mitigate, and learn from incidents — all without leaving Slack or your existing tools. Rootly automates on-call alerting, incident workflows, status page updates, and retrospectives so engineering teams can resolve issues faster and reduce toil.

Why Rootly?

  • End-to-End Incident Management: Create, track, update, and resolve incidents with full lifecycle support — from initial triage through retrospective.
  • On-Call Alerting: Create and manage alerts with deduplication, routing, and escalation to ensure the right people are notified immediately.
  • Timeline Events: Add structured timeline events to incidents for clear, auditable incident narratives.
  • Service Catalog: Maintain a catalog of services and map them to incidents for precise impact tracking.
  • Severity & Prioritization: Use configurable severity levels to prioritize incidents and drive appropriate response urgency.
  • Retrospectives: Access post-incident retrospectives to identify root causes, capture learnings, and drive reliability improvements.

Using Rootly in Sim

Sim's Rootly integration connects your agentic workflows directly to your Rootly account using an API key. With operations spanning incidents, alerts, services, severities, teams, environments, functionalities, incident types, and retrospectives, you can build powerful incident management automations without writing backend code.

Key benefits of using Rootly in Sim:

  • Automated incident creation: Trigger incident creation from monitoring alerts, customer reports, or anomaly detection workflows with full metadata including severity, services, and teams.
  • Incident lifecycle automation: Automatically update incident status, add timeline events, and attach mitigation or resolution messages as your response progresses.
  • Alert management: Create and list alerts with deduplication support to integrate Rootly into your existing monitoring and notification pipelines.
  • Organizational awareness: Query services, severities, teams, environments, functionalities, and incident types to build context-aware incident workflows.
  • Retrospective insights: List and filter retrospectives to feed post-incident learnings into continuous improvement workflows.

Whether you're automating incident response, building on-call alerting pipelines, or driving post-incident learning, Rootly in Sim gives you direct, secure access to the Rootly API — no middleware required. Simply configure your API key, select the operation you need, and let Sim handle the rest.

Usage Instructions

Integrate Rootly incident management into workflows. Create and manage incidents, alerts, services, severities, and retrospectives.

Tools

rootly_create_incident

Create a new incident in Rootly with optional severity, services, and teams.

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
titlestringNoThe title of the incident (auto-generated if not provided)
summarystringNoA summary of the incident
severityIdstringNoSeverity ID to attach to the incident
statusstringNoIncident status (in_triage, started, detected, acknowledged, mitigated, resolved, closed, cancelled, scheduled, in_progress, completed)
kindstringNoIncident kind (normal, normal_sub, test, test_sub, example, example_sub, backfilled, scheduled, scheduled_sub)
serviceIdsstringNoComma-separated service IDs to attach
environmentIdsstringNoComma-separated environment IDs to attach
groupIdsstringNoComma-separated team/group IDs to attach
incidentTypeIdsstringNoComma-separated incident type IDs to attach
functionalityIdsstringNoComma-separated functionality IDs to attach
labelsstringNoLabels as JSON object, e.g. {"platform":"osx","version":"1.29"}
privatebooleanNoCreate as a private incident (cannot be undone)

Output

ParameterTypeDescription
incidentobjectThe created incident
idstringUnique incident ID
sequentialIdnumberSequential incident number
titlestringIncident title
slugstringIncident slug
kindstringIncident kind
summarystringIncident summary
statusstringIncident status
privatebooleanWhether the incident is private
urlstringURL to the incident
shortUrlstringShort URL to the incident
severityNamestringSeverity name
severityIdstringSeverity ID
createdAtstringCreation date
updatedAtstringLast update date
startedAtstringStart date
mitigatedAtstringMitigation date
resolvedAtstringResolution date
closedAtstringClosed date

rootly_get_incident

Retrieve a single incident by ID from Rootly.

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
incidentIdstringYesThe ID of the incident to retrieve

Output

ParameterTypeDescription
incidentobjectThe incident details
idstringUnique incident ID
sequentialIdnumberSequential incident number
titlestringIncident title
slugstringIncident slug
kindstringIncident kind
summarystringIncident summary
statusstringIncident status
privatebooleanWhether the incident is private
urlstringURL to the incident
shortUrlstringShort URL to the incident
severityNamestringSeverity name
severityIdstringSeverity ID
createdAtstringCreation date
updatedAtstringLast update date
startedAtstringStart date
mitigatedAtstringMitigation date
resolvedAtstringResolution date
closedAtstringClosed date

rootly_update_incident

Update an existing incident in Rootly (status, severity, summary, etc.).

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
incidentIdstringYesThe ID of the incident to update
titlestringNoUpdated incident title
summarystringNoUpdated incident summary
severityIdstringNoUpdated severity ID
statusstringNoUpdated status (in_triage, started, detected, acknowledged, mitigated, resolved, closed, cancelled, scheduled, in_progress, completed)
kindstringNoIncident kind (normal, normal_sub, test, test_sub, example, example_sub, backfilled, scheduled, scheduled_sub)
privatebooleanNoSet incident as private (cannot be undone)
serviceIdsstringNoComma-separated service IDs
environmentIdsstringNoComma-separated environment IDs
groupIdsstringNoComma-separated team/group IDs
incidentTypeIdsstringNoComma-separated incident type IDs to attach
functionalityIdsstringNoComma-separated functionality IDs to attach
labelsstringNoLabels as JSON object, e.g. {"platform":"osx","version":"1.29"}
mitigationMessagestringNoHow was the incident mitigated?
resolutionMessagestringNoHow was the incident resolved?
cancellationMessagestringNoWhy was the incident cancelled?

Output

ParameterTypeDescription
incidentobjectThe updated incident
idstringUnique incident ID
sequentialIdnumberSequential incident number
titlestringIncident title
slugstringIncident slug
kindstringIncident kind
summarystringIncident summary
statusstringIncident status
privatebooleanWhether the incident is private
urlstringURL to the incident
shortUrlstringShort URL to the incident
severityNamestringSeverity name
severityIdstringSeverity ID
createdAtstringCreation date
updatedAtstringLast update date
startedAtstringStart date
mitigatedAtstringMitigation date
resolvedAtstringResolution date
closedAtstringClosed date

rootly_list_incidents

List incidents from Rootly with optional filtering by status, severity, and more.

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
statusstringNoFilter by status (in_triage, started, detected, acknowledged, mitigated, resolved, closed, cancelled, scheduled, in_progress, completed)
severitystringNoFilter by severity slug
searchstringNoSearch term to filter incidents
servicesstringNoFilter by service slugs (comma-separated)
teamsstringNoFilter by team slugs (comma-separated)
environmentsstringNoFilter by environment slugs (comma-separated)
sortstringNoSort order (e.g., -created_at, created_at, -started_at)
pageSizenumberNoNumber of items per page (default: 20)
pageNumbernumberNoPage number for pagination

Output

ParameterTypeDescription
incidentsarrayList of incidents
idstringUnique incident ID
sequentialIdnumberSequential incident number
titlestringIncident title
slugstringIncident slug
kindstringIncident kind
summarystringIncident summary
statusstringIncident status
privatebooleanWhether the incident is private
urlstringURL to the incident
shortUrlstringShort URL to the incident
severityNamestringSeverity name
severityIdstringSeverity ID
createdAtstringCreation date
updatedAtstringLast update date
startedAtstringStart date
mitigatedAtstringMitigation date
resolvedAtstringResolution date
closedAtstringClosed date
totalCountnumberTotal number of incidents returned

rootly_create_alert

Create a new alert in Rootly for on-call notification and routing.

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
summarystringYesThe summary of the alert
descriptionstringNoA detailed description of the alert
sourcestringYesThe source of the alert (e.g., api, manual, datadog, pagerduty)
statusstringNoAlert status on creation (open, triggered)
serviceIdsstringNoComma-separated service IDs to attach
groupIdsstringNoComma-separated team/group IDs to attach
environmentIdsstringNoComma-separated environment IDs to attach
externalIdstringNoExternal ID for the alert
externalUrlstringNoExternal URL for the alert
deduplicationKeystringNoAlerts sharing the same deduplication key are treated as a single alert

Output

ParameterTypeDescription
alertobjectThe created alert
idstringUnique alert ID
summarystringAlert summary
descriptionstringAlert description
sourcestringAlert source
statusstringAlert status
externalIdstringExternal ID
externalUrlstringExternal URL
deduplicationKeystringDeduplication key
createdAtstringCreation date
updatedAtstringLast update date

rootly_list_alerts

List alerts from Rootly with optional filtering by status, source, and services.

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
statusstringNoFilter by status (open, triggered, acknowledged, resolved)
sourcestringNoFilter by source (e.g., api, datadog, pagerduty)
servicesstringNoFilter by service slugs (comma-separated)
environmentsstringNoFilter by environment slugs (comma-separated)
groupsstringNoFilter by team/group slugs (comma-separated)
pageSizenumberNoNumber of items per page (default: 20)
pageNumbernumberNoPage number for pagination

Output

ParameterTypeDescription
alertsarrayList of alerts
idstringUnique alert ID
summarystringAlert summary
descriptionstringAlert description
sourcestringAlert source
statusstringAlert status
externalIdstringExternal ID
externalUrlstringExternal URL
deduplicationKeystringDeduplication key
createdAtstringCreation date
updatedAtstringLast update date
totalCountnumberTotal number of alerts returned

rootly_add_incident_event

Add a timeline event to an existing incident in Rootly.

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
incidentIdstringYesThe ID of the incident to add the event to
eventstringYesThe summary/description of the event
visibilitystringNoEvent visibility (internal or external)

Output

ParameterTypeDescription
eventIdstringThe ID of the created event
eventstringThe event summary
visibilitystringEvent visibility (internal or external)
occurredAtstringWhen the event occurred
createdAtstringCreation date
updatedAtstringLast update date

rootly_list_services

List services from Rootly with optional search filtering.

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
searchstringNoSearch term to filter services
pageSizenumberNoNumber of items per page (default: 20)
pageNumbernumberNoPage number for pagination

Output

ParameterTypeDescription
servicesarrayList of services
idstringUnique service ID
namestringService name
slugstringService slug
descriptionstringService description
colorstringService color
createdAtstringCreation date
updatedAtstringLast update date
totalCountnumberTotal number of services returned

rootly_list_severities

List severity levels configured in Rootly.

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
searchstringNoSearch term to filter severities
pageSizenumberNoNumber of items per page (default: 20)
pageNumbernumberNoPage number for pagination

Output

ParameterTypeDescription
severitiesarrayList of severity levels
idstringUnique severity ID
namestringSeverity name
slugstringSeverity slug
descriptionstringSeverity description
severitystringSeverity level (critical, high, medium, low)
colorstringSeverity color
positionnumberDisplay position
createdAtstringCreation date
updatedAtstringLast update date
totalCountnumberTotal number of severities returned

rootly_list_teams

List teams (groups) configured in Rootly.

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
searchstringNoSearch term to filter teams
pageSizenumberNoNumber of items per page (default: 20)
pageNumbernumberNoPage number for pagination

Output

ParameterTypeDescription
teamsarrayList of teams
idstringUnique team ID
namestringTeam name
slugstringTeam slug
descriptionstringTeam description
colorstringTeam color
createdAtstringCreation date
updatedAtstringLast update date
totalCountnumberTotal number of teams returned

rootly_list_environments

List environments configured in Rootly.

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
searchstringNoSearch term to filter environments
pageSizenumberNoNumber of items per page (default: 20)
pageNumbernumberNoPage number for pagination

Output

ParameterTypeDescription
environmentsarrayList of environments
idstringUnique environment ID
namestringEnvironment name
slugstringEnvironment slug
descriptionstringEnvironment description
colorstringEnvironment color
createdAtstringCreation date
updatedAtstringLast update date
totalCountnumberTotal number of environments returned

rootly_list_incident_types

List incident types configured in Rootly.

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
searchstringNoFilter incident types by name
pageSizenumberNoNumber of items per page (default: 20)
pageNumbernumberNoPage number for pagination

Output

ParameterTypeDescription
incidentTypesarrayList of incident types
idstringUnique incident type ID
namestringIncident type name
slugstringIncident type slug
descriptionstringIncident type description
colorstringIncident type color
createdAtstringCreation date
updatedAtstringLast update date
totalCountnumberTotal number of incident types returned

rootly_list_functionalities

List functionalities configured in Rootly.

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
searchstringNoSearch term to filter functionalities
pageSizenumberNoNumber of items per page (default: 20)
pageNumbernumberNoPage number for pagination

Output

ParameterTypeDescription
functionalitiesarrayList of functionalities
idstringUnique functionality ID
namestringFunctionality name
slugstringFunctionality slug
descriptionstringFunctionality description
colorstringFunctionality color
createdAtstringCreation date
updatedAtstringLast update date
totalCountnumberTotal number of functionalities returned

rootly_list_retrospectives

List incident retrospectives (post-mortems) from Rootly.

Input

ParameterTypeRequiredDescription
apiKeystringYesRootly API key
statusstringNoFilter by status (draft, published)
searchstringNoSearch term to filter retrospectives
pageSizenumberNoNumber of items per page (default: 20)
pageNumbernumberNoPage number for pagination

Output

ParameterTypeDescription
retrospectivesarrayList of retrospectives
idstringUnique retrospective ID
titlestringRetrospective title
statusstringStatus (draft or published)
urlstringURL to the retrospective
startedAtstringIncident start date
mitigatedAtstringMitigation date
resolvedAtstringResolution date
createdAtstringCreation date
updatedAtstringLast update date
totalCountnumberTotal number of retrospectives returned

On this page

Start building today
Trusted by over 100,000 builders.
The open-source platform to build AI agents and run your agentic workforce.
Get started