AptlyStar

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 (e.g., 10, 25, 50). Default: 25
afterstringNoPagination cursor to fetch the next page of results (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

Output

ParameterTypeDescription
incidentsarrayList of incidents
↳ idstringIncident ID
↳ namestringIncident name/title
↳ summarystringIncident summary
↳ descriptionstringIncident description
↳ modestringIncident mode (standard, retrospective, test)
↳ call_urlstringVideo call URL
↳ severityobjectIncident severity
↳ idstringSeverity ID
↳ namestringSeverity name (e.g., Critical, Major, Minor)
↳ descriptionstringSeverity description
↳ ranknumberSeverity rank (lower = more severe)
↳ statusobjectCurrent incident status
↳ idstringStatus ID
↳ namestringStatus name
↳ descriptionstringStatus description
↳ categorystringStatus category (triage, active, post-incident, closed)
↳ incident_typeobjectIncident type
↳ idstringIncident type ID
↳ namestringIncident type name
↳ descriptionstringIncident type description
↳ is_defaultbooleanWhether this is the default incident type
↳ created_atstringWhen the incident was created (ISO 8601)
↳ updated_atstringWhen the incident was last updated (ISO 8601)
↳ incident_urlstringURL to the incident page
↳ slack_channel_idstringSlack channel ID
↳ slack_channel_namestringSlack channel name
↳ visibilitystringIncident visibility (public, private)
pagination_metaobjectPagination metadata
↳ afterstringCursor for next page
↳ page_sizenumberNumber of items per page
↳ total_record_countnumberTotal number of records

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 (e.g., "Database connection issues")
summarystringNoBrief summary of the incident (e.g., "Intermittent connection failures to primary database")
severity_idstringYesID of the severity level (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")
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
↳ idstringIncident ID
↳ namestringIncident 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
↳ statusobjectCurrent status of the incident
↳ idstringStatus ID
↳ namestringStatus name
↳ 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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

Output

ParameterTypeDescription
incidentobjectDetailed incident information
↳ idstringIncident ID
↳ namestringIncident 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
↳ statusobjectCurrent status of the incident
↳ idstringStatus ID
↳ namestringStatus name
↳ 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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")
namestringNoUpdated name of the incident (e.g., "Database connection issues")
summarystringNoUpdated summary of the incident (e.g., "Intermittent connection failures to primary database")
severity_idstringNoUpdated severity ID for the incident (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")
incident_status_idstringNoUpdated status ID for the incident (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")
incident_type_idstringNoUpdated incident type ID
notify_incident_channelbooleanYesWhether to notify the incident channel about this update

Output

ParameterTypeDescription
incidentobjectThe updated incident object
↳ idstringIncident ID
↳ namestringIncident 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
↳ statusobjectCurrent status of the incident
↳ idstringStatus ID
↳ namestringStatus name
↳ 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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

Output

ParameterTypeDescription
actionsarrayList of actions
↳ idstringAction ID
↳ descriptionstringAction description
↳ assigneeobjectAssigned user
↳ idstringUser ID
↳ 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

incidentio_actions_show

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

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesAction ID (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

Output

ParameterTypeDescription
actionobjectAction details
↳ idstringAction ID
↳ descriptionstringAction description
↳ assigneeobjectAssigned user
↳ idstringUser ID
↳ 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

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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

Output

ParameterTypeDescription
follow_upsarrayList of follow-ups
↳ idstringFollow-up ID
↳ titlestringFollow-up title
↳ descriptionstringFollow-up description
↳ assigneeobjectAssigned user
↳ idstringUser ID
↳ namestringUser name
↳ emailstringUser email
↳ statusstringFollow-up status
↳ priorityobjectFollow-up priority
↳ idstringPriority ID
↳ namestringPriority name
↳ descriptionstringPriority description
↳ 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

incidentio_follow_ups_show

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

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesFollow-up ID (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

Output

ParameterTypeDescription
follow_upobjectFollow-up details
↳ idstringFollow-up ID
↳ titlestringFollow-up title
↳ descriptionstringFollow-up description
↳ assigneeobjectAssigned user
↳ idstringUser ID
↳ namestringUser name
↳ emailstringUser email
↳ statusstringFollow-up status
↳ priorityobjectFollow-up priority
↳ idstringPriority ID
↳ namestringPriority name
↳ descriptionstringPriority description
↳ 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

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 (e.g., 10, 25, 50). Default: 25
afterstringNoPagination cursor to fetch the next page of results

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
pagination_metaobjectPagination metadata
↳ afterstringCursor for next page
↳ page_sizenumberNumber of items per page
↳ total_record_countnumberTotal number of records

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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

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 (e.g., 10, 25, 50)
afterstringNoPagination cursor to fetch the next page of results (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

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_create

Create a new workflow in incident.io.

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
namestringYesName of the workflow (e.g., "Notify on Critical Incidents")
folderstringNoFolder to organize the workflow in
statestringNoState of the workflow (active, draft, or disabled)
triggerstringNoTrigger type for the workflow (e.g., "incident.updated", "incident.created")
stepsstringNoArray of workflow steps as JSON string. Example: [{"label": "Notify team", "name": "slack.post_message"}]
condition_groupsstringNoArray of condition groups as JSON string to control when the workflow runs. Example: [{"conditions": [{"operation": "one_of", "param_bindings": [], "subject": "incident.severity"}]}]
runs_on_incidentsstringNoWhen to run the workflow: "newly_created" (only new incidents), "newly_created_and_active" (new and active incidents), "active" (only active incidents), or "all" (all incidents)
runs_on_incident_modesstringNoArray of incident modes to run on as JSON string. Example: ["standard", "retrospective"]
include_private_incidentsbooleanNoWhether to include private incidents
continue_on_step_errorbooleanNoWhether to continue executing subsequent steps if a step fails
once_forstringNoArray of fields to ensure the workflow runs only once per unique combination of these fields, as JSON string. Example: ["incident.id"]
expressionsstringNoArray of workflow expressions as JSON string for advanced workflow logic. Example: [{"label": "My expression", "operations": []}]
delaystringNoDelay configuration as JSON string. Example: {"for_seconds": 60, "conditions_apply_over_delay": false}

Output

ParameterTypeDescription
workflowobjectThe created 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_show

Get details of a specific workflow in incident.io.

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the workflow to retrieve (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")
namestringYesNew name for the workflow (e.g., "Notify on Critical Incidents")
stepsstringYesComplete array of workflow steps as a JSON string
condition_groupsstringYesComplete array of workflow condition groups as a JSON string
runs_on_incidentsstringYesWhen to run the workflow: newly_created, newly_created_and_active, active, or all
runs_on_incident_modesstringYesComplete array of incident modes to run on as a JSON string
include_private_incidentsbooleanYesWhether to include private incidents
continue_on_step_errorbooleanYesWhether to continue executing subsequent steps if a step fails
once_forstringYesComplete array of fields that make the workflow run once as a JSON string
expressionsstringYesComplete array of workflow expressions as a JSON string
statestringNoNew state for the workflow (active, draft, or disabled)
folderstringNoNew folder for the workflow
delaystringNoDelay configuration as a JSON string

Output

ParameterTypeDescription
workflowobjectThe updated workflow
↳ idstringWorkflow ID
↳ namestringWorkflow name
↳ statestringWorkflow state (active, draft, disabled)
↳ folderstringWorkflow folder
↳ created_atstringWhen the workflow was created
↳ updated_atstringWhen the workflow was last updated
management_metajsonWorkflow management metadata

incidentio_workflows_delete

Delete a workflow in incident.io.

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
idstringYesThe ID of the workflow to delete (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

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 (e.g., 10, 25, 50). Default: 25
afterstringNoPagination cursor to fetch the next page of results (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

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 (e.g., "Primary On-Call")
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"}]}]}

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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")
namestringNoNew name for the schedule (e.g., "Primary On-Call")
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"}]}]}

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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

Output

ParameterTypeDescription
messagestringSuccess message

incidentio_escalations_list

List all escalation policies in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key

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 (e.g., "Database Critical Alert")
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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

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 (e.g., "Affected Service")
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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")
namestringYesNew name for the custom field (e.g., "Affected Service")
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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

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 (e.g., "Incident Commander")
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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")
namestringYesName of the incident role (e.g., "Incident Commander")
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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0"). If not provided, returns all updates
page_sizenumberNoNumber of results to return per page (e.g., 10, 25, 50)
afterstringNoCursor for pagination (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

Output

ParameterTypeDescription
incident_updatesarrayList of incident updates
↳ idstringThe update ID
↳ incident_idstringThe incident ID
↳ messagestringThe update message
↳ new_severityobjectNew severity if changed
↳ idstringSeverity ID
↳ namestringSeverity name
↳ ranknumberSeverity rank
↳ new_statusobjectNew status if changed
↳ idstringStatus ID
↳ namestringStatus name
↳ categorystringStatus category
↳ updaterobjectUser who created the update
↳ idstringUser ID
↳ namestringUser name
↳ 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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")
entry_window_startstringNoStart date/time to filter entries in ISO 8601 format (e.g., "2024-01-15T09:00:00Z")
entry_window_endstringNoEnd date/time to filter entries in ISO 8601 format (e.g., "2024-01-22T09:00:00Z")
page_sizenumberNoNumber of results to return per page (e.g., 10, 25, 50)
afterstringNoCursor for pagination (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

Output

ParameterTypeDescription
schedule_entriesarrayList of schedule entries
↳ idstringThe entry ID
↳ schedule_idstringThe schedule ID
↳ userobjectUser assigned to this entry
↳ idstringUser ID
↳ 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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")
schedule_idstringYesThe ID of the schedule (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")
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 in ISO 8601 format (e.g., "2024-01-15T09:00:00Z")
end_atstringYesWhen the override ends in ISO 8601 format (e.g., "2024-01-22T09:00:00Z")

Output

ParameterTypeDescription
overrideobjectThe created schedule override
↳ idstringThe override ID
↳ rotation_idstringThe rotation ID
↳ schedule_idstringThe schedule ID
↳ userobjectUser assigned to this override
↳ idstringUser ID
↳ 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_list

List escalation paths in incident.io

Input

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

Output

ParameterTypeDescription
escalation_pathsarrayList of escalation paths
↳ idstringThe escalation path ID
↳ namestringThe escalation path name
↳ patharrayArray of escalation levels
↳ working_hoursarrayWorking hours configuration
pagination_metaobjectPagination metadata
↳ afterstringCursor for next page
↳ page_sizenumberNumber of results per page

incidentio_escalation_paths_create

Create a new escalation path in incident.io

Input

ParameterTypeRequiredDescription
apiKeystringYesincident.io API Key
namestringYesName of the escalation path (e.g., "Critical Incident 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
↳ idstringThe escalation path 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
↳ time_to_ack_secondsnumberTime to acknowledge in seconds
↳ working_hoursarrayWorking hours configuration
↳ 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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

Output

ParameterTypeDescription
escalation_pathobjectThe escalation path details
↳ idstringThe escalation path 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
↳ time_to_ack_secondsnumberTime to acknowledge in seconds
↳ working_hoursarrayWorking hours configuration
↳ 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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")
namestringNoNew name for the escalation path (e.g., "Critical Incident 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
↳ idstringThe escalation path 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
↳ time_to_ack_secondsnumberTime to acknowledge in seconds
↳ working_hoursarrayWorking hours configuration
↳ 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 (e.g., "01FCNDV6P870EA6S7TK1DSYDG0")

Output

ParameterTypeDescription
messagestringSuccess message

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