---
title: incidentio
description: Manage incidents with incident.io
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="incidentio"
  color="#E0E0E0"
/>

{/* MANUAL-CONTENT-START:intro */}
Supercharge your incident management with [incident.io](https://incident.io) – the leading platform for orchestrating incidents, streamlining response processes, and tracking action items all in one place. Seamlessly integrate incident.io into your automated workflows to take command of incident creation, real-time collaboration, follow-ups, scheduling, escalations, and much more.

With the incident.io tool, you can:

- **List and search incidents**: Quickly retrieve a list of ongoing or historical incidents, complete with metadata such as severity, status, and timestamps, using `incidentio_incidents_list`.
- **Create new incidents**: Trigger new incident creation programmatically via `incidentio_incidents_create`, specifying severity, name, type, and custom details to ensure nothing slows your response down.
- **Automate incident follow-ups**: Leverage incident.io’s powerful automation to ensure important action items and learnings aren't missed, helping teams resolve issues and improve processes.
- **Customize workflows**: Integrate bespoke incident types, severities, and custom fields tailored to your organization’s needs.
- **Enforce best practices with schedules & escalations**: Streamline on-call and incident management by automatically assigning, notifying, and escalating as situations evolve.

incident.io empowers modern organizations to respond faster, coordinate teams, and capture learnings for continuous improvement. Whether you manage SRE, DevOps, Security, or IT incidents, incident.io brings centralized, best-in-class incident response programmatically to your agent workflows.

**Key operations available**:
- `incidentio_incidents_list`: List, paginate and filter incidents with full detail.
- `incidentio_incidents_create`: Programmatically open new incidents with custom attributes and control over duplication (idempotency).
- ...and more to come!

Enhance your reliability, accountability, and operational excellence by integrating incident.io with your workflow automations today.
{/* MANUAL-CONTENT-END */}


## Usage Instructions

Integrate incident.io into the workflow. Manage incidents, actions, follow-ups, workflows, schedules, escalations, custom fields, and more.



## Tools

### `incidentio_incidents_list`

List incidents from incident.io. Returns a list of incidents with their details including severity, status, and timestamps.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `page_size` | number | No | Number of incidents to return per page \(default: 25\) |
| `after` | string | No | Pagination cursor to fetch the next page of results |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incidents` | array | List of incidents |

### `incidentio_incidents_create`

Create a new incident in incident.io. Requires idempotency_key, severity_id, and visibility. Optionally accepts name, summary, type, and status.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `idempotency_key` | string | Yes | Unique identifier to prevent duplicate incident creation. Use a UUID or unique string. |
| `name` | string | No | Name of the incident \(optional\) |
| `summary` | string | No | Brief summary of the incident |
| `severity_id` | string | Yes | ID of the severity level \(required\) |
| `incident_type_id` | string | No | ID of the incident type |
| `incident_status_id` | string | No | ID of the initial incident status |
| `visibility` | string | Yes | Visibility of the incident: "public" or "private" \(required\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident` | object | The created incident object |

### `incidentio_incidents_show`

Retrieve detailed information about a specific incident from incident.io by its ID. Returns full incident details including custom fields and role assignments.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | ID of the incident to retrieve |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident` | object | Detailed incident information |

### `incidentio_incidents_update`

Update an existing incident in incident.io. Can update name, summary, severity, status, or type.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | ID of the incident to update |
| `name` | string | No | Updated name of the incident |
| `summary` | string | No | Updated summary of the incident |
| `severity_id` | string | No | Updated severity ID for the incident |
| `incident_status_id` | string | No | Updated status ID for the incident |
| `incident_type_id` | string | No | Updated incident type ID |
| `notify_incident_channel` | boolean | Yes | Whether to notify the incident channel about this update |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident` | object | The updated incident object |

### `incidentio_actions_list`

List actions from incident.io. Optionally filter by incident ID.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `incident_id` | string | No | Filter actions by incident ID |
| `page_size` | number | No | Number of actions to return per page |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `actions` | array | List of actions |

### `incidentio_actions_show`

Get detailed information about a specific action from incident.io.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | Action ID |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `action` | object | Action details |

### `incidentio_follow_ups_list`

List follow-ups from incident.io. Optionally filter by incident ID.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `incident_id` | string | No | Filter follow-ups by incident ID |
| `page_size` | number | No | Number of follow-ups to return per page |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `follow_ups` | array | List of follow-ups |

### `incidentio_follow_ups_show`

Get detailed information about a specific follow-up from incident.io.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | Follow-up ID |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `follow_up` | object | Follow-up details |

### `incidentio_users_list`

List all users in your Incident.io workspace. Returns user details including id, name, email, and role.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Incident.io API Key |
| `page_size` | number | No | Number of results to return per page \(default: 25\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `users` | array | List of users in the workspace |

### `incidentio_users_show`

Get detailed information about a specific user in your Incident.io workspace by their ID.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Incident.io API Key |
| `id` | string | Yes | The unique identifier of the user to retrieve |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `user` | object | Details of the requested user |

### `incidentio_workflows_list`

List all workflows in your incident.io workspace.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `page_size` | number | No | Number of workflows to return per page |
| `after` | string | No | Pagination cursor to fetch the next page of results |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `workflows` | array | List of workflows |

### `incidentio_workflows_show`

Get details of a specific workflow in incident.io.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the workflow to retrieve |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `workflow` | object | The workflow details |

### `incidentio_workflows_update`

Update an existing workflow in incident.io.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the workflow to update |
| `name` | string | No | New name for the workflow |
| `state` | string | No | New state for the workflow \(active, draft, or disabled\) |
| `folder` | string | No | New folder for the workflow |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `workflow` | object | The updated workflow |

### `incidentio_workflows_delete`

Delete a workflow in incident.io.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the workflow to delete |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success message |

### `incidentio_schedules_list`

List all schedules in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `page_size` | number | No | Number of results per page \(default: 25\) |
| `after` | string | No | Pagination cursor to fetch the next page of results |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `schedules` | array | List of schedules |

### `incidentio_schedules_create`

Create a new schedule in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `name` | string | Yes | Name of the schedule |
| `timezone` | string | Yes | Timezone for the schedule \(e.g., America/New_York\) |
| `config` | string | Yes | Schedule configuration as JSON string with rotations. Example: \{"rotations": \[\{"name": "Primary", "users": \[\{"id": "user_id"\}\], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": \[\{"interval": 1, "interval_type": "weekly"\}\]\}\]\} |
| `Example` | string | No | No description |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `schedule` | object | The created schedule |

### `incidentio_schedules_show`

Get details of a specific schedule in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the schedule |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `schedule` | object | The schedule details |

### `incidentio_schedules_update`

Update an existing schedule in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the schedule to update |
| `name` | string | No | New name for the schedule |
| `timezone` | string | No | New timezone for the schedule \(e.g., America/New_York\) |
| `config` | string | No | Schedule configuration as JSON string with rotations. Example: \{"rotations": \[\{"name": "Primary", "users": \[\{"id": "user_id"\}\], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": \[\{"interval": 1, "interval_type": "weekly"\}\]\}\]\} |
| `Example` | string | No | No description |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `schedule` | object | The updated schedule |

### `incidentio_schedules_delete`

Delete a schedule in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the schedule to delete |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success message |

### `incidentio_escalations_list`

List all escalation policies in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `page_size` | number | No | Number of results per page \(default: 25\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `escalations` | array | List of escalation policies |

### `incidentio_escalations_create`

Create a new escalation policy in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `idempotency_key` | string | Yes | Unique identifier to prevent duplicate escalation creation. Use a UUID or unique string. |
| `title` | string | Yes | Title of the escalation |
| `escalation_path_id` | string | No | ID of the escalation path to use \(required if user_ids not provided\) |
| `user_ids` | string | No | Comma-separated list of user IDs to notify \(required if escalation_path_id not provided\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `escalation` | object | The created escalation policy |

### `incidentio_escalations_show`

Get details of a specific escalation policy in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the escalation policy |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `escalation` | object | The escalation policy details |

### `incidentio_custom_fields_list`

List all custom fields from incident.io.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `custom_fields` | array | List of custom fields |

### `incidentio_custom_fields_create`

Create a new custom field in incident.io.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `name` | string | Yes | Name of the custom field |
| `description` | string | Yes | Description of the custom field \(required\) |
| `field_type` | string | Yes | Type of the custom field \(e.g., text, single_select, multi_select, numeric, datetime, link, user, team\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `custom_field` | object | Created custom field |

### `incidentio_custom_fields_show`

Get detailed information about a specific custom field from incident.io.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | Custom field ID |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `custom_field` | object | Custom field details |

### `incidentio_custom_fields_update`

Update an existing custom field in incident.io.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | Custom field ID |
| `name` | string | Yes | New name for the custom field \(required\) |
| `description` | string | Yes | New description for the custom field \(required\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `custom_field` | object | Updated custom field |

### `incidentio_custom_fields_delete`

Delete a custom field from incident.io.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | Custom field ID |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success message |

### `incidentio_severities_list`

List all severity levels configured in your Incident.io workspace. Returns severity details including id, name, description, and rank.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Incident.io API Key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `severities` | array | List of severity levels |

### `incidentio_incident_statuses_list`

List all incident statuses configured in your Incident.io workspace. Returns status details including id, name, description, and category.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Incident.io API Key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_statuses` | array | List of incident statuses |

### `incidentio_incident_types_list`

List all incident types configured in your Incident.io workspace. Returns type details including id, name, description, and default flag.

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | Incident.io API Key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_types` | array | List of incident types |

### `incidentio_incident_roles_list`

List all incident roles in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_roles` | array | List of incident roles |

### `incidentio_incident_roles_create`

Create a new incident role in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `name` | string | Yes | Name of the incident role |
| `description` | string | Yes | Description of the incident role |
| `instructions` | string | Yes | Instructions for the incident role |
| `shortform` | string | Yes | Short form abbreviation for the role |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_role` | object | The created incident role |

### `incidentio_incident_roles_show`

Get details of a specific incident role in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the incident role |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_role` | object | The incident role details |

### `incidentio_incident_roles_update`

Update an existing incident role in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the incident role to update |
| `name` | string | Yes | Name of the incident role |
| `description` | string | Yes | Description of the incident role |
| `instructions` | string | Yes | Instructions for the incident role |
| `shortform` | string | Yes | Short form abbreviation for the role |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_role` | object | The updated incident role |

### `incidentio_incident_roles_delete`

Delete an incident role in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the incident role to delete |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success message |

### `incidentio_incident_timestamps_list`

List all incident timestamp definitions in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_timestamps` | array | List of incident timestamp definitions |

### `incidentio_incident_timestamps_show`

Get details of a specific incident timestamp definition in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the incident timestamp |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_timestamp` | object | The incident timestamp details |

### `incidentio_incident_updates_list`

List all updates for a specific incident in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `incident_id` | string | No | The ID of the incident to get updates for \(optional - if not provided, returns all updates\) |
| `page_size` | number | No | Number of results to return per page |
| `after` | string | No | Cursor for pagination |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `incident_updates` | array | List of incident updates |

### `incidentio_schedule_entries_list`

List all entries for a specific schedule in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `schedule_id` | string | Yes | The ID of the schedule to get entries for |
| `entry_window_start` | string | No | Start date/time to filter entries \(ISO 8601 format\) |
| `entry_window_end` | string | No | End date/time to filter entries \(ISO 8601 format\) |
| `page_size` | number | No | Number of results to return per page |
| `after` | string | No | Cursor for pagination |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `schedule_entries` | array | List of schedule entries |

### `incidentio_schedule_overrides_create`

Create a new schedule override in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `rotation_id` | string | Yes | The ID of the rotation to override |
| `schedule_id` | string | Yes | The ID of the schedule |
| `user_id` | string | No | The ID of the user to assign \(provide one of: user_id, user_email, or user_slack_id\) |
| `user_email` | string | No | The email of the user to assign \(provide one of: user_id, user_email, or user_slack_id\) |
| `user_slack_id` | string | No | The Slack ID of the user to assign \(provide one of: user_id, user_email, or user_slack_id\) |
| `start_at` | string | Yes | When the override starts \(ISO 8601 format\) |
| `end_at` | string | Yes | When the override ends \(ISO 8601 format\) |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `override` | object | The created schedule override |

### `incidentio_escalation_paths_create`

Create a new escalation path in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `name` | string | Yes | Name of the escalation path |
| `path` | json | Yes | Array of escalation levels with targets and time to acknowledge in seconds. Each level should have: targets \(array of \{id, type, schedule_id?, user_id?, urgency\}\) and time_to_ack_seconds \(number\) |
| `working_hours` | json | No | Optional working hours configuration. Array of \{weekday, start_time, end_time\} |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `escalation_path` | object | The created escalation path |

### `incidentio_escalation_paths_show`

Get details of a specific escalation path in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the escalation path |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `escalation_path` | object | The escalation path details |

### `incidentio_escalation_paths_update`

Update an existing escalation path in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the escalation path to update |
| `name` | string | No | New name for the escalation path |
| `path` | json | No | New escalation path configuration. Array of escalation levels with targets and time_to_ack_seconds |
| `working_hours` | json | No | New working hours configuration. Array of \{weekday, start_time, end_time\} |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `escalation_path` | object | The updated escalation path |

### `incidentio_escalation_paths_delete`

Delete an escalation path in incident.io

#### Input

| Parameter | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `apiKey` | string | Yes | incident.io API Key |
| `id` | string | Yes | The ID of the escalation path to delete |

#### Output

| Parameter | Type | Description |
| --------- | ---- | ----------- |
| `message` | string | Success message |



## Notes

- Category: `tools`
- Type: `incidentio`
