Sim

incidentio

Manage incidents with incident.io

Supercharge your incident management with 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.

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

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
page_sizenumberNoNumber of incidents to return per page (default: 25)
afterstringNoPagination cursor to fetch the next page of results

Output

ParameterTypeDescription
incidentsarrayList 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

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idempotency_keystringYesUnique identifier to prevent duplicate incident creation. Use a UUID or unique string.
namestringNoName of the incident (optional)
summarystringNoBrief summary of the incident
severity_idstringYesID of the severity level (required)
incident_type_idstringNoID of the incident type
incident_status_idstringNoID of the initial incident status
visibilitystringYesVisibility of the incident: "public" or "private" (required)

Output

ParameterTypeDescription
incidentobjectThe 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

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesID of the incident to retrieve

Output

ParameterTypeDescription
incidentobjectDetailed incident information

incidentio_incidents_update

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

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesID of the incident to update
namestringNoUpdated name of the incident
summarystringNoUpdated summary of the incident
severity_idstringNoUpdated severity ID for the incident
incident_status_idstringNoUpdated status ID for the incident
incident_type_idstringNoUpdated incident type ID
notify_incident_channelbooleanYesWhether to notify the incident channel about this update

Output

ParameterTypeDescription
incidentobjectThe updated incident object

incidentio_actions_list

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

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
incident_idstringNoFilter actions by incident ID
page_sizenumberNoNumber of actions to return per page

Output

ParameterTypeDescription
actionsarrayList of actions

incidentio_actions_show

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

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesAction ID

Output

ParameterTypeDescription
actionobjectAction details

incidentio_follow_ups_list

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

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
incident_idstringNoFilter follow-ups by incident ID
page_sizenumberNoNumber of follow-ups to return per page

Output

ParameterTypeDescription
follow_upsarrayList of follow-ups

incidentio_follow_ups_show

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

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesFollow-up ID

Output

ParameterTypeDescription
follow_upobjectFollow-up details

incidentio_users_list

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

Input

ParameterTypeRequiredDescription
apiKeystringYesIncident.io API Key
page_sizenumberNoNumber of results to return per page (default: 25)

Output

ParameterTypeDescription
usersarrayList of users in the workspace

incidentio_users_show

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

Input

ParameterTypeRequiredDescription
apiKeystringYesIncident.io API Key
idstringYesThe unique identifier of the user to retrieve

Output

ParameterTypeDescription
userobjectDetails of the requested user

incidentio_workflows_list

List all workflows in your incident.io workspace.

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
page_sizenumberNoNumber of workflows to return per page
afterstringNoPagination cursor to fetch the next page of results

Output

ParameterTypeDescription
workflowsarrayList of workflows

incidentio_workflows_show

Get details of a specific workflow in incident.io.

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the workflow to retrieve

Output

ParameterTypeDescription
workflowobjectThe workflow details

incidentio_workflows_update

Update an existing workflow in incident.io.

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the workflow to update
namestringNoNew name for the workflow
statestringNoNew state for the workflow (active, draft, or disabled)
folderstringNoNew folder for the workflow

Output

ParameterTypeDescription
workflowobjectThe updated workflow

incidentio_workflows_delete

Delete a workflow in incident.io.

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the workflow to delete

Output

ParameterTypeDescription
messagestringSuccess message

incidentio_schedules_list

List all schedules in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
page_sizenumberNoNumber of results per page (default: 25)
afterstringNoPagination cursor to fetch the next page of results

Output

ParameterTypeDescription
schedulesarrayList of schedules

incidentio_schedules_create

Create a new schedule in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
namestringYesName of the schedule
timezonestringYesTimezone for the schedule (e.g., America/New_York)
configstringYesSchedule 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"}]}]}
ExamplestringNoNo description

Output

ParameterTypeDescription
scheduleobjectThe created schedule

incidentio_schedules_show

Get details of a specific schedule in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the schedule

Output

ParameterTypeDescription
scheduleobjectThe schedule details

incidentio_schedules_update

Update an existing schedule in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the schedule to update
namestringNoNew name for the schedule
timezonestringNoNew timezone for the schedule (e.g., America/New_York)

Output

ParameterTypeDescription
scheduleobjectThe updated schedule

incidentio_schedules_delete

Delete a schedule in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the schedule to delete

Output

ParameterTypeDescription
messagestringSuccess message

incidentio_escalations_list

List all escalation policies in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
page_sizenumberNoNumber of results per page (default: 25)

Output

ParameterTypeDescription
escalationsarrayList of escalation policies

incidentio_escalations_create

Create a new escalation policy in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idempotency_keystringYesUnique identifier to prevent duplicate escalation creation. Use a UUID or unique string.
titlestringYesTitle of the escalation
escalation_path_idstringNoID of the escalation path to use (required if user_ids not provided)
user_idsstringNoComma-separated list of user IDs to notify (required if escalation_path_id not provided)

Output

ParameterTypeDescription
escalationobjectThe created escalation policy

incidentio_escalations_show

Get details of a specific escalation policy in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the escalation policy

Output

ParameterTypeDescription
escalationobjectThe escalation policy details

incidentio_custom_fields_list

List all custom fields from incident.io.

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key

Output

ParameterTypeDescription
custom_fieldsarrayList of custom fields

incidentio_custom_fields_create

Create a new custom field in incident.io.

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
namestringYesName of the custom field
descriptionstringYesDescription of the custom field (required)
field_typestringYesType of the custom field (e.g., text, single_select, multi_select, numeric, datetime, link, user, team)

Output

ParameterTypeDescription
custom_fieldobjectCreated custom field

incidentio_custom_fields_show

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

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesCustom field ID

Output

ParameterTypeDescription
custom_fieldobjectCustom field details

incidentio_custom_fields_update

Update an existing custom field in incident.io.

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesCustom field ID
namestringYesNew name for the custom field (required)
descriptionstringYesNew description for the custom field (required)

Output

ParameterTypeDescription
custom_fieldobjectUpdated custom field

incidentio_custom_fields_delete

Delete a custom field from incident.io.

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesCustom field ID

Output

ParameterTypeDescription
messagestringSuccess message

incidentio_severities_list

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

Input

ParameterTypeRequiredDescription
apiKeystringYesIncident.io API Key

Output

ParameterTypeDescription
severitiesarrayList 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

ParameterTypeRequiredDescription
apiKeystringYesIncident.io API Key

Output

ParameterTypeDescription
incident_statusesarrayList 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

ParameterTypeRequiredDescription
apiKeystringYesIncident.io API Key

Output

ParameterTypeDescription
incident_typesarrayList of incident types

incidentio_incident_roles_list

List all incident roles in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key

Output

ParameterTypeDescription
incident_rolesarrayList of incident roles

incidentio_incident_roles_create

Create a new incident role in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
namestringYesName of the incident role
descriptionstringYesDescription of the incident role
instructionsstringYesInstructions for the incident role
shortformstringYesShort form abbreviation for the role

Output

ParameterTypeDescription
incident_roleobjectThe created incident role

incidentio_incident_roles_show

Get details of a specific incident role in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the incident role

Output

ParameterTypeDescription
incident_roleobjectThe incident role details

incidentio_incident_roles_update

Update an existing incident role in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the incident role to update
namestringYesName of the incident role
descriptionstringYesDescription of the incident role
instructionsstringYesInstructions for the incident role
shortformstringYesShort form abbreviation for the role

Output

ParameterTypeDescription
incident_roleobjectThe updated incident role

incidentio_incident_roles_delete

Delete an incident role in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the incident role to delete

Output

ParameterTypeDescription
messagestringSuccess message

incidentio_incident_timestamps_list

List all incident timestamp definitions in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key

Output

ParameterTypeDescription
incident_timestampsarrayList of incident timestamp definitions

incidentio_incident_timestamps_show

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

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the incident timestamp

Output

ParameterTypeDescription
incident_timestampobjectThe incident timestamp details

incidentio_incident_updates_list

List all updates for a specific incident in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
incident_idstringNoThe ID of the incident to get updates for (optional - if not provided, returns all updates)
page_sizenumberNoNumber of results to return per page
afterstringNoCursor for pagination

Output

ParameterTypeDescription
incident_updatesarrayList of incident updates

incidentio_schedule_entries_list

List all entries for a specific schedule in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
schedule_idstringYesThe ID of the schedule to get entries for
entry_window_startstringNoStart date/time to filter entries (ISO 8601 format)
entry_window_endstringNoEnd date/time to filter entries (ISO 8601 format)
page_sizenumberNoNumber of results to return per page
afterstringNoCursor for pagination

Output

ParameterTypeDescription
schedule_entriesarrayList of schedule entries

incidentio_schedule_overrides_create

Create a new schedule override in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
rotation_idstringYesThe ID of the rotation to override
schedule_idstringYesThe ID of the schedule
user_idstringNoThe ID of the user to assign (provide one of: user_id, user_email, or user_slack_id)
user_emailstringNoThe email of the user to assign (provide one of: user_id, user_email, or user_slack_id)
user_slack_idstringNoThe Slack ID of the user to assign (provide one of: user_id, user_email, or user_slack_id)
start_atstringYesWhen the override starts (ISO 8601 format)
end_atstringYesWhen the override ends (ISO 8601 format)

Output

ParameterTypeDescription
overrideobjectThe created schedule override

incidentio_escalation_paths_create

Create a new escalation path in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
namestringYesName of the escalation path
pathjsonYesArray 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_hoursjsonNoOptional working hours configuration. Array of {weekday, start_time, end_time}

Output

ParameterTypeDescription
escalation_pathobjectThe created escalation path

incidentio_escalation_paths_show

Get details of a specific escalation path in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the escalation path

Output

ParameterTypeDescription
escalation_pathobjectThe escalation path details

incidentio_escalation_paths_update

Update an existing escalation path in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the escalation path to update
namestringNoNew name for the escalation path
pathjsonNoNew escalation path configuration. Array of escalation levels with targets and time_to_ack_seconds
working_hoursjsonNoNew working hours configuration. Array of {weekday, start_time, end_time}

Output

ParameterTypeDescription
escalation_pathobjectThe updated escalation path

incidentio_escalation_paths_delete

Delete an escalation path in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the escalation path to delete

Output

ParameterTypeDescription
messagestringSuccess message

Notes

  • Category: tools
  • Type: incidentio
On this page

On this page

Usage Instructions
Tools
incidentio_incidents_list
Input
Output
incidentio_incidents_create
Input
Output
incidentio_incidents_show
Input
Output
incidentio_incidents_update
Input
Output
incidentio_actions_list
Input
Output
incidentio_actions_show
Input
Output
incidentio_follow_ups_list
Input
Output
incidentio_follow_ups_show
Input
Output
incidentio_users_list
Input
Output
incidentio_users_show
Input
Output
incidentio_workflows_list
Input
Output
incidentio_workflows_show
Input
Output
incidentio_workflows_update
Input
Output
incidentio_workflows_delete
Input
Output
incidentio_schedules_list
Input
Output
incidentio_schedules_create
Input
Output
incidentio_schedules_show
Input
Output
incidentio_schedules_update
Input
Output
incidentio_schedules_delete
Input
Output
incidentio_escalations_list
Input
Output
incidentio_escalations_create
Input
Output
incidentio_escalations_show
Input
Output
incidentio_custom_fields_list
Input
Output
incidentio_custom_fields_create
Input
Output
incidentio_custom_fields_show
Input
Output
incidentio_custom_fields_update
Input
Output
incidentio_custom_fields_delete
Input
Output
incidentio_severities_list
Input
Output
incidentio_incident_statuses_list
Input
Output
incidentio_incident_types_list
Input
Output
incidentio_incident_roles_list
Input
Output
incidentio_incident_roles_create
Input
Output
incidentio_incident_roles_show
Input
Output
incidentio_incident_roles_update
Input
Output
incidentio_incident_roles_delete
Input
Output
incidentio_incident_timestamps_list
Input
Output
incidentio_incident_timestamps_show
Input
Output
incidentio_incident_updates_list
Input
Output
incidentio_schedule_entries_list
Input
Output
incidentio_schedule_overrides_create
Input
Output
incidentio_escalation_paths_create
Input
Output
incidentio_escalation_paths_show
Input
Output
incidentio_escalation_paths_update
Input
Output
incidentio_escalation_paths_delete
Input
Output
Notes
Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started