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
idstringType ID
namestringType name
summarystringBrief summary of the incident
descriptionstringDetailed description of the incident
modestringIncident mode (e.g., standard, retrospective)
call_urlstringURL for the incident call/bridge
severityobjectSeverity of the incident
idstringSeverity ID
namestringSeverity name
ranknumberSeverity rank
ranknumberSeverity rank
statusobjectCurrent status of the incident
idstringStatus ID
namestringStatus name
categorystringStatus category
categorystringStatus category
incident_typeobjectType of the incident
idstringType ID
namestringType name
created_atstringCreation timestamp
updated_atstringLast update timestamp
incident_urlstringURL to the incident
slack_channel_idstringAssociated Slack channel ID
slack_channel_namestringAssociated Slack channel name
visibilitystringIncident visibility
pagination_metaobjectPagination metadata
afterstringCursor for the next page
page_sizenumberNumber of items per page
total_record_countnumberTotal number of records available

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
idstringType ID
namestringType name
summarystringBrief summary of the incident
descriptionstringDetailed description of the incident
modestringIncident mode (e.g., standard, retrospective)
call_urlstringURL for the incident call/bridge
severityobjectSeverity of the incident
idstringSeverity ID
namestringSeverity name
ranknumberSeverity rank
ranknumberSeverity rank
statusobjectCurrent status of the incident
idstringStatus ID
namestringStatus name
categorystringStatus category
categorystringStatus category
incident_typeobjectType of the incident
idstringType ID
namestringType name
created_atstringCreation timestamp
updated_atstringLast update timestamp
incident_urlstringURL to the incident
slack_channel_idstringAssociated Slack channel ID
slack_channel_namestringAssociated Slack channel name
visibilitystringIncident visibility

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
idstringType ID
namestringType name
summarystringBrief summary of the incident
descriptionstringDetailed description of the incident
modestringIncident mode (e.g., standard, retrospective)
call_urlstringURL for the incident call/bridge
permalinkstringPermanent link to the incident
severityobjectSeverity of the incident
idstringSeverity ID
namestringSeverity name
ranknumberSeverity rank
ranknumberSeverity rank
statusobjectCurrent status of the incident
idstringStatus ID
namestringStatus name
categorystringStatus category
categorystringStatus category
incident_typeobjectType of the incident
idstringType ID
namestringType name
created_atstringCreation timestamp
updated_atstringLast update timestamp
incident_urlstringURL to the incident
slack_channel_idstringAssociated Slack channel ID
slack_channel_namestringAssociated Slack channel name
visibilitystringIncident visibility
custom_field_entriesarrayCustom field values for the incident
incident_role_assignmentsarrayRole assignments for the incident

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
idstringType ID
namestringType name
summarystringBrief summary of the incident
descriptionstringDetailed description of the incident
modestringIncident mode (e.g., standard, retrospective)
call_urlstringURL for the incident call/bridge
severityobjectSeverity of the incident
idstringSeverity ID
namestringSeverity name
ranknumberSeverity rank
ranknumberSeverity rank
statusobjectCurrent status of the incident
idstringStatus ID
namestringStatus name
categorystringStatus category
categorystringStatus category
incident_typeobjectType of the incident
idstringType ID
namestringType name
created_atstringCreation timestamp
updated_atstringLast update timestamp
incident_urlstringURL to the incident
slack_channel_idstringAssociated Slack channel ID
slack_channel_namestringAssociated Slack channel name
visibilitystringIncident visibility

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
idstringUser ID
descriptionstringAction description
assigneeobjectAssigned user
idstringUser ID
namestringUser name
emailstringUser email
namestringUser name
emailstringUser email
statusstringAction status
due_atstringDue date/time
created_atstringCreation timestamp
updated_atstringLast update timestamp
incident_idstringAssociated incident ID
creatorobjectUser who created the action
idstringUser ID
namestringUser name
emailstringUser email
completed_atstringCompletion timestamp
external_issue_referenceobjectExternal issue tracking reference
providerstringIssue tracking provider (e.g., Jira, Linear)
issue_namestringIssue identifier
issue_permalinkstringURL to the external issue
providerstringIssue tracking provider (e.g., Jira, Linear)
issue_namestringIssue identifier
issue_permalinkstringURL to the external issue

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
idstringUser ID
descriptionstringAction description
assigneeobjectAssigned user
idstringUser ID
namestringUser name
emailstringUser email
namestringUser name
emailstringUser email
statusstringAction status
due_atstringDue date/time
created_atstringCreation timestamp
updated_atstringLast update timestamp
incident_idstringAssociated incident ID
creatorobjectUser who created the action
idstringUser ID
namestringUser name
emailstringUser email
completed_atstringCompletion timestamp
external_issue_referenceobjectExternal issue tracking reference
providerstringIssue tracking provider (e.g., Jira, Linear)
issue_namestringIssue identifier
issue_permalinkstringURL to the external issue
providerstringIssue tracking provider (e.g., Jira, Linear)
issue_namestringIssue identifier
issue_permalinkstringURL to the external issue

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
idstringUser ID
titlestringFollow-up title
descriptionstringPriority description
assigneeobjectAssigned user
idstringUser ID
namestringUser name
emailstringUser email
namestringUser name
emailstringUser email
statusstringFollow-up status
priorityobjectFollow-up priority
idstringPriority ID
namestringPriority name
descriptionstringPriority description
ranknumberPriority rank
ranknumberPriority rank
created_atstringCreation timestamp
updated_atstringLast update timestamp
incident_idstringAssociated incident ID
creatorobjectUser who created the follow-up
idstringUser ID
namestringUser name
emailstringUser email
completed_atstringCompletion timestamp
labelsarrayLabels associated with the follow-up
external_issue_referenceobjectExternal issue tracking reference
providerstringExternal provider name
issue_namestringExternal issue name or ID
issue_permalinkstringPermalink to external issue
providerstringExternal provider name
issue_namestringExternal issue name or ID
issue_permalinkstringPermalink to external issue

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
idstringUser ID
titlestringFollow-up title
descriptionstringPriority description
assigneeobjectAssigned user
idstringUser ID
namestringUser name
emailstringUser email
namestringUser name
emailstringUser email
statusstringFollow-up status
priorityobjectFollow-up priority
idstringPriority ID
namestringPriority name
descriptionstringPriority description
ranknumberPriority rank
ranknumberPriority rank
created_atstringCreation timestamp
updated_atstringLast update timestamp
incident_idstringAssociated incident ID
creatorobjectUser who created the follow-up
idstringUser ID
namestringUser name
emailstringUser email
completed_atstringCompletion timestamp
labelsarrayLabels associated with the follow-up
external_issue_referenceobjectExternal issue tracking reference
providerstringExternal provider name
issue_namestringExternal issue name or ID
issue_permalinkstringPermalink to external issue
providerstringExternal provider name
issue_namestringExternal issue name or ID
issue_permalinkstringPermalink to external issue

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
idstringUnique identifier for the user
namestringFull name of the user
emailstringEmail address of the user
rolestringRole of the user 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
idstringUnique identifier for the user
namestringFull name of the user
emailstringEmail address of the user
rolestringRole of the user in the workspace

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
idstringUnique identifier for the workflow
namestringName of the workflow
statestringState of the workflow (active, draft, or disabled)
folderstringFolder the workflow belongs to
created_atstringWhen the workflow was created
updated_atstringWhen the workflow was last updated
pagination_metaobjectPagination metadata
afterstringCursor for next page
page_sizenumberNumber of results per page

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
idstringUnique identifier for the workflow
namestringName of the workflow
statestringState of the workflow (active, draft, or disabled)
folderstringFolder the workflow belongs to
created_atstringWhen the workflow was created
updated_atstringWhen the workflow was last updated

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
idstringUnique identifier for the workflow
namestringName of the workflow
statestringState of the workflow (active, draft, or disabled)
folderstringFolder the workflow belongs to
created_atstringWhen the workflow was created
updated_atstringWhen the workflow was last updated

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
idstringThe schedule ID
namestringThe schedule name
timezonestringThe schedule timezone
created_atstringWhen the schedule was created
updated_atstringWhen the schedule was last updated
pagination_metaobjectPagination metadata
afterstringCursor for next page
page_sizenumberNumber of results per page

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
idstringThe schedule ID
namestringThe schedule name
timezonestringThe schedule timezone
created_atstringWhen the schedule was created
updated_atstringWhen the schedule was last updated

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
idstringThe schedule ID
namestringThe schedule name
timezonestringThe schedule timezone
created_atstringWhen the schedule was created
updated_atstringWhen the schedule was last updated

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)
configstringNoSchedule 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 updated schedule
idstringThe schedule ID
namestringThe schedule name
timezonestringThe schedule timezone
created_atstringWhen the schedule was created
updated_atstringWhen the schedule was last updated

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
idstringThe escalation policy ID
namestringThe escalation policy name
created_atstringWhen the escalation policy was created
updated_atstringWhen the escalation policy was last updated

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
idstringThe escalation policy ID
namestringThe escalation policy name
created_atstringWhen the escalation policy was created
updated_atstringWhen the escalation policy was last updated

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
idstringThe escalation policy ID
namestringThe escalation policy name
created_atstringWhen the escalation policy was created
updated_atstringWhen the escalation policy was last updated

incidentio_custom_fields_list

List all custom fields from incident.io.

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key

Output

ParameterTypeDescription
custom_fieldsarrayList of custom fields
idstringCustom field ID
namestringCustom field name
descriptionstringCustom field description
field_typestringCustom field type
created_atstringCreation timestamp
updated_atstringLast update timestamp

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
idstringCustom field ID
namestringCustom field name
descriptionstringCustom field description
field_typestringCustom field type
created_atstringCreation timestamp
updated_atstringLast update timestamp

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
idstringCustom field ID
namestringCustom field name
descriptionstringCustom field description
field_typestringCustom field type
created_atstringCreation timestamp
updated_atstringLast update timestamp

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
idstringCustom field ID
namestringCustom field name
descriptionstringCustom field description
field_typestringCustom field type
created_atstringCreation timestamp
updated_atstringLast update timestamp

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
idstringUnique identifier for the severity level
namestringName of the severity level
descriptionstringDescription of the severity level
ranknumberRank/order of the severity level

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
idstringUnique identifier for the incident status
namestringName of the incident status
descriptionstringDescription of the incident status
categorystringCategory of the incident status

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
idstringUnique identifier for the incident type
namestringName of the incident type
descriptionstringDescription of the incident type
is_defaultbooleanWhether this is the default incident type

incidentio_incident_roles_list

List all incident roles in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key

Output

ParameterTypeDescription
incident_rolesarrayList of incident roles
idstringThe incident role ID
namestringThe incident role name
descriptionstringThe incident role description
instructionsstringInstructions for the role
shortformstringShort form abbreviation of the role
role_typestringThe type of role
requiredbooleanWhether the role is required
created_atstringWhen the role was created
updated_atstringWhen the role was last updated

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
idstringThe incident role ID
namestringThe incident role name
descriptionstringThe incident role description
instructionsstringInstructions for the role
shortformstringShort form abbreviation of the role
role_typestringThe type of role
requiredbooleanWhether the role is required
created_atstringWhen the role was created
updated_atstringWhen the role was last updated

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
idstringThe incident role ID
namestringThe incident role name
descriptionstringThe incident role description
instructionsstringInstructions for the role
shortformstringShort form abbreviation of the role
role_typestringThe type of role
requiredbooleanWhether the role is required
created_atstringWhen the role was created
updated_atstringWhen the role was last updated

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
idstringThe incident role ID
namestringThe incident role name
descriptionstringThe incident role description
instructionsstringInstructions for the role
shortformstringShort form abbreviation of the role
role_typestringThe type of role
requiredbooleanWhether the role is required
created_atstringWhen the role was created
updated_atstringWhen the role was last updated

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
idstringThe timestamp ID
namestringThe timestamp name
ranknumberThe rank/order of the timestamp
created_atstringWhen the timestamp was created
updated_atstringWhen the timestamp was last updated

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
idstringThe timestamp ID
namestringThe timestamp name
ranknumberThe rank/order of the timestamp
created_atstringWhen the timestamp was created
updated_atstringWhen the timestamp was last updated

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
idstringUser ID
incident_idstringThe incident ID
messagestringThe update message
new_severityobjectNew severity if changed
idstringSeverity ID
namestringSeverity name
ranknumberSeverity rank
namestringUser name
ranknumberSeverity rank
new_statusobjectNew status if changed
idstringStatus ID
namestringStatus name
categorystringStatus category
categorystringStatus category
updaterobjectUser who created the update
idstringUser ID
namestringUser name
emailstringUser email
emailstringUser email
created_atstringWhen the update was created
updated_atstringWhen the update was last modified
pagination_metaobjectPagination information
afterstringCursor for next page
page_sizenumberNumber of results per page

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
idstringUser ID
schedule_idstringThe schedule ID
userobjectUser assigned to this entry
idstringUser ID
namestringUser name
emailstringUser email
namestringUser name
emailstringUser email
start_atstringWhen the entry starts
end_atstringWhen the entry ends
layer_idstringThe schedule layer ID
created_atstringWhen the entry was created
updated_atstringWhen the entry was last updated
pagination_metaobjectPagination information
afterstringCursor for next page
after_urlstringURL for next page
page_sizenumberNumber of results per page

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
idstringUser ID
rotation_idstringThe rotation ID
schedule_idstringThe schedule ID
userobjectUser assigned to this override
idstringUser ID
namestringUser name
emailstringUser email
namestringUser name
emailstringUser email
start_atstringWhen the override starts
end_atstringWhen the override ends
created_atstringWhen the override was created
updated_atstringWhen the override was last updated

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
idstringTarget ID
namestringThe escalation path name
patharrayArray of escalation levels
targetsarrayTargets for this level
idstringTarget ID
typestringTarget type
schedule_idstringSchedule ID if type is schedule
user_idstringUser ID if type is user
urgencystringUrgency level
idstringTarget ID
typestringTarget type
schedule_idstringSchedule ID if type is schedule
user_idstringUser ID if type is user
urgencystringUrgency level
time_to_ack_secondsnumberTime to acknowledge in seconds
targetsarrayTargets for this level
idstringTarget ID
typestringTarget type
schedule_idstringSchedule ID if type is schedule
user_idstringUser ID if type is user
urgencystringUrgency level
typestringTarget type
schedule_idstringSchedule ID if type is schedule
user_idstringUser ID if type is user
urgencystringUrgency level
time_to_ack_secondsnumberTime to acknowledge in seconds
working_hoursarrayWorking hours configuration
weekdaystringDay of week
start_timestringStart time
end_timestringEnd time
weekdaystringDay of week
start_timestringStart time
end_timestringEnd time
created_atstringWhen the path was created
updated_atstringWhen the path was last updated

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
idstringTarget ID
namestringThe escalation path name
patharrayArray of escalation levels
targetsarrayTargets for this level
idstringTarget ID
typestringTarget type
schedule_idstringSchedule ID if type is schedule
user_idstringUser ID if type is user
urgencystringUrgency level
idstringTarget ID
typestringTarget type
schedule_idstringSchedule ID if type is schedule
user_idstringUser ID if type is user
urgencystringUrgency level
time_to_ack_secondsnumberTime to acknowledge in seconds
targetsarrayTargets for this level
idstringTarget ID
typestringTarget type
schedule_idstringSchedule ID if type is schedule
user_idstringUser ID if type is user
urgencystringUrgency level
typestringTarget type
schedule_idstringSchedule ID if type is schedule
user_idstringUser ID if type is user
urgencystringUrgency level
time_to_ack_secondsnumberTime to acknowledge in seconds
working_hoursarrayWorking hours configuration
weekdaystringDay of week
start_timestringStart time
end_timestringEnd time
weekdaystringDay of week
start_timestringStart time
end_timestringEnd time
created_atstringWhen the path was created
updated_atstringWhen the path was last updated

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
idstringTarget ID
namestringThe escalation path name
patharrayArray of escalation levels
targetsarrayTargets for this level
idstringTarget ID
typestringTarget type
schedule_idstringSchedule ID if type is schedule
user_idstringUser ID if type is user
urgencystringUrgency level
idstringTarget ID
typestringTarget type
schedule_idstringSchedule ID if type is schedule
user_idstringUser ID if type is user
urgencystringUrgency level
time_to_ack_secondsnumberTime to acknowledge in seconds
targetsarrayTargets for this level
idstringTarget ID
typestringTarget type
schedule_idstringSchedule ID if type is schedule
user_idstringUser ID if type is user
urgencystringUrgency level
typestringTarget type
schedule_idstringSchedule ID if type is schedule
user_idstringUser ID if type is user
urgencystringUrgency level
time_to_ack_secondsnumberTime to acknowledge in seconds
working_hoursarrayWorking hours configuration
weekdaystringDay of week
start_timestringStart time
end_timestringEnd time
weekdaystringDay of week
start_timestringStart time
end_timestringEnd time
created_atstringWhen the path was created
updated_atstringWhen the path was last updated

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