Rootly connects to a Nagent workspace with an API key. Once it is connected, agents can call 6 Rootly actions, such as "Get Action Item Details", "Get Incident Details" and "List Action Items". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Rootly, with input parameters and output schema.
ROOTLY_DELETE_ACTION_ITEMThis 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
The unique identifier (UUID) of the action item to delete. Use ROOTLY_LIST_ACTION_ITEMS to find action item IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ROOTLY_DELETE_INCIDENTTool 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
The unique identifier of the incident to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ROOTLY_GET_ACTION_ITEMRetrieves 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
The unique identifier of the action item to retrieve. Use ROOTLY_LIST_ACTION_ITEMS to discover available action item IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ROOTLY_GET_INCIDENTTool 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
The ID of the incident to retrieve (UUID or slug format)
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ROOTLY_LIST_ACTION_ITEMSThis 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
Kind of action item in Rootly.
Status of action items.
Priority levels for action items.
Number of items per page
Page number for pagination
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ROOTLY_UPDATE_INCIDENTTool 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
The ID of the incident to update (UUID or slug format)
Data object containing the incident type and attributes to update
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 6 Rootly actions on Nagent, including "Get Action Item Details", "Get Incident Details" and "List Action Items". Get Action Item Details: Retrieves detailed information about a specific action item by its ID from Rootly. Each action is listed on this page with its input parameters and its output.
Rootly connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Get Action Item Details takes 1 required input: action_item_id. It returns data, error and successful.