# Rootly

Rootly is an AI-native incident management platform that automates workflows and collaboration, integrating with Slack, PagerDuty, and other tools to streamline incident response.

- **Category:** it operations
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 6
- **Triggers:** 0
- **Slug:** `ROOTLY`
- **Version:** 20260211_00

## Tools

### Delete Action Item

**Slug:** `ROOTLY_DELETE_ACTION_ITEM`

This tool allows for the deletion of a specific action item in Rootly. It complements the existing ROOTLY_LIST_ACTION_ITEMS functionality by providing the ability to remove individual action items from the system.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `action_item_id` | string | Yes | The unique identifier (UUID) of the action item to delete. Use ROOTLY_LIST_ACTION_ITEMS to find action item IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Incident

**Slug:** `ROOTLY_DELETE_INCIDENT`

Tool to delete an incident in Rootly by ID. Use when performing administrative cleanup. This is a destructive operation and depends on appropriate Rootly permissions.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the incident to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Action Item Details

**Slug:** `ROOTLY_GET_ACTION_ITEM`

Retrieves detailed information about a specific action item by its ID from Rootly. Action items are tasks or follow-up items created during incident management to track work that needs to be completed. This tool returns comprehensive details including: - Core info: summary, description, kind (task/follow_up), priority, status, due_date - Assignment: assigned user and group IDs - Integration links: Jira, GitHub, GitLab, Linear, Asana, Trello, ClickUp, and other connected tools - Metadata: creation and update timestamps, direct URL to the action item Use ROOTLY_LIST_ACTION_ITEMS first to discover available action item IDs if you don't already have one.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `action_item_id` | string | Yes | The unique identifier of the action item to retrieve. Use ROOTLY_LIST_ACTION_ITEMS to discover available action item IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Incident Details

**Slug:** `ROOTLY_GET_INCIDENT`

Tool to retrieve full details for a single Rootly incident by ID. Use when you need complete incident information for drill-down after listing or searching incidents. Supports optional include parameter to fetch related resources like environments, services, action_items, and events in a single request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the incident to retrieve (UUID or slug format) |
| `include` | string | No | Comma-separated list of related resources to include in response. Available options: sub_statuses, causes, subscribers, roles, slack_messages, environments, incident_types, services, functionalities, groups, events, action_items, custom_field_selections, feedbacks, incident_post_mortem, alerts |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Action Items

**Slug:** `ROOTLY_LIST_ACTION_ITEMS`

This tool retrieves a list of all action items for an organization in Rootly. Action items are tasks or follow-up items that need to be completed during or after an incident, helping to track and manage incident-related tasks effectively.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `kind` | string ("task" | "follow_up") | No | Kind of action item in Rootly. |
| `status` | string ("open" | "in_progress" | "cancelled" | "done") | No | Status of action items. |
| `priority` | string ("high" | "medium" | "low") | No | Priority levels for action items. |
| `page_size` | integer | No | Number of items per page |
| `page_number` | integer | No | Page number for pagination |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Incident

**Slug:** `ROOTLY_UPDATE_INCIDENT`

Tool to update fields on an existing Rootly incident by ID. Use when you need to modify incident status, severity, metadata, or other attributes. Supports updating title, status, summary, severity_id, service_ids, environment_ids, and more.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The ID of the incident to update (UUID or slug format) |
| `data` | object | Yes | Data object containing the incident type and attributes to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |