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.
Integrate Rootly incident management into workflows. Create and manage incidents, alerts, services, severities, and retrospectives.
Create a new incident in Rootly with optional severity, services, and teams.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
title | string | No | The title of the incident (auto-generated if not provided) |
summary | string | No | A summary of the incident |
severityId | string | No | Severity ID to attach to the incident |
status | string | No | Incident status (in_triage, started, detected, acknowledged, mitigated, resolved, closed, cancelled, scheduled, in_progress, completed) |
kind | string | No | Incident kind (normal, normal_sub, test, test_sub, example, example_sub, backfilled, scheduled, scheduled_sub) |
serviceIds | string | No | Comma-separated service IDs to attach |
environmentIds | string | No | Comma-separated environment IDs to attach |
groupIds | string | No | Comma-separated team/group IDs to attach |
incidentTypeIds | string | No | Comma-separated incident type IDs to attach |
functionalityIds | string | No | Comma-separated functionality IDs to attach |
labels | string | No | Labels as JSON object, e.g. {"platform":"osx","version":"1.29"} |
private | boolean | No | Create as a private incident (cannot be undone) |
| Parameter | Type | Description |
|---|
incident | object | The created incident |
↳ id | string | Unique incident ID |
↳ sequentialId | number | Sequential incident number |
↳ title | string | Incident title |
↳ slug | string | Incident slug |
↳ kind | string | Incident kind |
↳ summary | string | Incident summary |
↳ status | string | Incident status |
↳ private | boolean | Whether the incident is private |
↳ url | string | URL to the incident |
↳ shortUrl | string | Short URL to the incident |
↳ severityName | string | Severity name |
↳ severityId | string | Severity ID |
↳ createdAt | string | Creation date |
↳ updatedAt | string | Last update date |
↳ startedAt | string | Start date |
↳ mitigatedAt | string | Mitigation date |
↳ resolvedAt | string | Resolution date |
↳ closedAt | string | Closed date |
Retrieve a single incident by ID from Rootly.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
incidentId | string | Yes | The ID of the incident to retrieve |
| Parameter | Type | Description |
|---|
incident | object | The incident details |
↳ id | string | Unique incident ID |
↳ sequentialId | number | Sequential incident number |
↳ title | string | Incident title |
↳ slug | string | Incident slug |
↳ kind | string | Incident kind |
↳ summary | string | Incident summary |
↳ status | string | Incident status |
↳ private | boolean | Whether the incident is private |
↳ url | string | URL to the incident |
↳ shortUrl | string | Short URL to the incident |
↳ severityName | string | Severity name |
↳ severityId | string | Severity ID |
↳ createdAt | string | Creation date |
↳ updatedAt | string | Last update date |
↳ startedAt | string | Start date |
↳ mitigatedAt | string | Mitigation date |
↳ resolvedAt | string | Resolution date |
↳ closedAt | string | Closed date |
Update an existing incident in Rootly (status, severity, summary, etc.).
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
incidentId | string | Yes | The ID of the incident to update |
title | string | No | Updated incident title |
summary | string | No | Updated incident summary |
severityId | string | No | Updated severity ID |
status | string | No | Updated status (in_triage, started, detected, acknowledged, mitigated, resolved, closed, cancelled, scheduled, in_progress, completed) |
kind | string | No | Incident kind (normal, normal_sub, test, test_sub, example, example_sub, backfilled, scheduled, scheduled_sub) |
private | boolean | No | Set incident as private (cannot be undone) |
serviceIds | string | No | Comma-separated service IDs |
environmentIds | string | No | Comma-separated environment IDs |
groupIds | string | No | Comma-separated team/group IDs |
incidentTypeIds | string | No | Comma-separated incident type IDs to attach |
functionalityIds | string | No | Comma-separated functionality IDs to attach |
labels | string | No | Labels as JSON object, e.g. {"platform":"osx","version":"1.29"} |
mitigationMessage | string | No | How was the incident mitigated? |
resolutionMessage | string | No | How was the incident resolved? |
cancellationMessage | string | No | Why was the incident cancelled? |
| Parameter | Type | Description |
|---|
incident | object | The updated incident |
↳ id | string | Unique incident ID |
↳ sequentialId | number | Sequential incident number |
↳ title | string | Incident title |
↳ slug | string | Incident slug |
↳ kind | string | Incident kind |
↳ summary | string | Incident summary |
↳ status | string | Incident status |
↳ private | boolean | Whether the incident is private |
↳ url | string | URL to the incident |
↳ shortUrl | string | Short URL to the incident |
↳ severityName | string | Severity name |
↳ severityId | string | Severity ID |
↳ createdAt | string | Creation date |
↳ updatedAt | string | Last update date |
↳ startedAt | string | Start date |
↳ mitigatedAt | string | Mitigation date |
↳ resolvedAt | string | Resolution date |
↳ closedAt | string | Closed date |
List incidents from Rootly with optional filtering by status, severity, and more.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
status | string | No | Filter by status (in_triage, started, detected, acknowledged, mitigated, resolved, closed, cancelled, scheduled, in_progress, completed) |
severity | string | No | Filter by severity slug |
search | string | No | Search term to filter incidents |
services | string | No | Filter by service slugs (comma-separated) |
teams | string | No | Filter by team slugs (comma-separated) |
environments | string | No | Filter by environment slugs (comma-separated) |
sort | string | No | Sort order (e.g., -created_at, created_at, -started_at) |
pageSize | number | No | Number of items per page (default: 20) |
pageNumber | number | No | Page number for pagination |
| Parameter | Type | Description |
|---|
incidents | array | List of incidents |
↳ id | string | Unique incident ID |
↳ sequentialId | number | Sequential incident number |
↳ title | string | Incident title |
↳ slug | string | Incident slug |
↳ kind | string | Incident kind |
↳ summary | string | Incident summary |
↳ status | string | Incident status |
↳ private | boolean | Whether the incident is private |
↳ url | string | URL to the incident |
↳ shortUrl | string | Short URL to the incident |
↳ severityName | string | Severity name |
↳ severityId | string | Severity ID |
↳ createdAt | string | Creation date |
↳ updatedAt | string | Last update date |
↳ startedAt | string | Start date |
↳ mitigatedAt | string | Mitigation date |
↳ resolvedAt | string | Resolution date |
↳ closedAt | string | Closed date |
totalCount | number | Total number of incidents returned |
Create a new alert in Rootly for on-call notification and routing.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
summary | string | Yes | The summary of the alert |
description | string | No | A detailed description of the alert |
source | string | Yes | The source of the alert (e.g., api, manual, datadog, pagerduty) |
status | string | No | Alert status on creation (open, triggered) |
serviceIds | string | No | Comma-separated service IDs to attach |
groupIds | string | No | Comma-separated team/group IDs to attach |
environmentIds | string | No | Comma-separated environment IDs to attach |
externalId | string | No | External ID for the alert |
externalUrl | string | No | External URL for the alert |
deduplicationKey | string | No | Alerts sharing the same deduplication key are treated as a single alert |
| Parameter | Type | Description |
|---|
alert | object | The created alert |
↳ id | string | Unique alert ID |
↳ summary | string | Alert summary |
↳ description | string | Alert description |
↳ source | string | Alert source |
↳ status | string | Alert status |
↳ externalId | string | External ID |
↳ externalUrl | string | External URL |
↳ deduplicationKey | string | Deduplication key |
↳ createdAt | string | Creation date |
↳ updatedAt | string | Last update date |
List alerts from Rootly with optional filtering by status, source, and services.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
status | string | No | Filter by status (open, triggered, acknowledged, resolved) |
source | string | No | Filter by source (e.g., api, datadog, pagerduty) |
services | string | No | Filter by service slugs (comma-separated) |
environments | string | No | Filter by environment slugs (comma-separated) |
groups | string | No | Filter by team/group slugs (comma-separated) |
pageSize | number | No | Number of items per page (default: 20) |
pageNumber | number | No | Page number for pagination |
| Parameter | Type | Description |
|---|
alerts | array | List of alerts |
↳ id | string | Unique alert ID |
↳ summary | string | Alert summary |
↳ description | string | Alert description |
↳ source | string | Alert source |
↳ status | string | Alert status |
↳ externalId | string | External ID |
↳ externalUrl | string | External URL |
↳ deduplicationKey | string | Deduplication key |
↳ createdAt | string | Creation date |
↳ updatedAt | string | Last update date |
totalCount | number | Total number of alerts returned |
Add a timeline event to an existing incident in Rootly.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
incidentId | string | Yes | The ID of the incident to add the event to |
event | string | Yes | The summary/description of the event |
visibility | string | No | Event visibility (internal or external) |
| Parameter | Type | Description |
|---|
eventId | string | The ID of the created event |
event | string | The event summary |
visibility | string | Event visibility (internal or external) |
occurredAt | string | When the event occurred |
createdAt | string | Creation date |
updatedAt | string | Last update date |
List services from Rootly with optional search filtering.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
search | string | No | Search term to filter services |
pageSize | number | No | Number of items per page (default: 20) |
pageNumber | number | No | Page number for pagination |
| Parameter | Type | Description |
|---|
services | array | List of services |
↳ id | string | Unique service ID |
↳ name | string | Service name |
↳ slug | string | Service slug |
↳ description | string | Service description |
↳ color | string | Service color |
↳ createdAt | string | Creation date |
↳ updatedAt | string | Last update date |
totalCount | number | Total number of services returned |
List severity levels configured in Rootly.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
search | string | No | Search term to filter severities |
pageSize | number | No | Number of items per page (default: 20) |
pageNumber | number | No | Page number for pagination |
| Parameter | Type | Description |
|---|
severities | array | List of severity levels |
↳ id | string | Unique severity ID |
↳ name | string | Severity name |
↳ slug | string | Severity slug |
↳ description | string | Severity description |
↳ severity | string | Severity level (critical, high, medium, low) |
↳ color | string | Severity color |
↳ position | number | Display position |
↳ createdAt | string | Creation date |
↳ updatedAt | string | Last update date |
totalCount | number | Total number of severities returned |
List teams (groups) configured in Rootly.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
search | string | No | Search term to filter teams |
pageSize | number | No | Number of items per page (default: 20) |
pageNumber | number | No | Page number for pagination |
| Parameter | Type | Description |
|---|
teams | array | List of teams |
↳ id | string | Unique team ID |
↳ name | string | Team name |
↳ slug | string | Team slug |
↳ description | string | Team description |
↳ color | string | Team color |
↳ createdAt | string | Creation date |
↳ updatedAt | string | Last update date |
totalCount | number | Total number of teams returned |
List environments configured in Rootly.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
search | string | No | Search term to filter environments |
pageSize | number | No | Number of items per page (default: 20) |
pageNumber | number | No | Page number for pagination |
| Parameter | Type | Description |
|---|
environments | array | List of environments |
↳ id | string | Unique environment ID |
↳ name | string | Environment name |
↳ slug | string | Environment slug |
↳ description | string | Environment description |
↳ color | string | Environment color |
↳ createdAt | string | Creation date |
↳ updatedAt | string | Last update date |
totalCount | number | Total number of environments returned |
List incident types configured in Rootly.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
search | string | No | Filter incident types by name |
pageSize | number | No | Number of items per page (default: 20) |
pageNumber | number | No | Page number for pagination |
| Parameter | Type | Description |
|---|
incidentTypes | array | List of incident types |
↳ id | string | Unique incident type ID |
↳ name | string | Incident type name |
↳ slug | string | Incident type slug |
↳ description | string | Incident type description |
↳ color | string | Incident type color |
↳ createdAt | string | Creation date |
↳ updatedAt | string | Last update date |
totalCount | number | Total number of incident types returned |
List functionalities configured in Rootly.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
search | string | No | Search term to filter functionalities |
pageSize | number | No | Number of items per page (default: 20) |
pageNumber | number | No | Page number for pagination |
| Parameter | Type | Description |
|---|
functionalities | array | List of functionalities |
↳ id | string | Unique functionality ID |
↳ name | string | Functionality name |
↳ slug | string | Functionality slug |
↳ description | string | Functionality description |
↳ color | string | Functionality color |
↳ createdAt | string | Creation date |
↳ updatedAt | string | Last update date |
totalCount | number | Total number of functionalities returned |
List incident retrospectives (post-mortems) from Rootly.
| Parameter | Type | Required | Description |
|---|
apiKey | string | Yes | Rootly API key |
status | string | No | Filter by status (draft, published) |
search | string | No | Search term to filter retrospectives |
pageSize | number | No | Number of items per page (default: 20) |
pageNumber | number | No | Page number for pagination |
| Parameter | Type | Description |
|---|
retrospectives | array | List of retrospectives |
↳ id | string | Unique retrospective ID |
↳ title | string | Retrospective title |
↳ status | string | Status (draft or published) |
↳ url | string | URL to the retrospective |
↳ startedAt | string | Incident start date |
↳ mitigatedAt | string | Mitigation date |
↳ resolvedAt | string | Resolution date |
↳ createdAt | string | Creation date |
↳ updatedAt | string | Last update date |
totalCount | number | Total number of retrospectives returned |