Overview Add incident.io to any ModuleX agent or workflow. Incident management and on-call response against the incident.io REST API (api.incident.io). Manage incidents, actions, follow-ups, workflows, schedules, escalations, escalation paths, custom fields, incident roles, and reference data.
Categories : Monitoring & Observability · Incident Management · On Call · Auth : API Key · Actions : 46
Authentication API Key Authentication Authenticate using your incident.io API key
Step 1
Log in to your incident.io dashboard
Step 2
Go to Settings -> API keys
Step 3
Create a new API key and select the permissions it should have
Step 4
Copy the key (it is shown only once) and paste it below
Required Credentials Field Description Required Format incident.io API Key Your incident.io API key from Settings -> API keys Yes -
Available Actions
incidents_list — List incidents from incident.io. Returns a list of incidents with their details including severity, status, and timestamps.
Parameters Number of results to return per page (e.g., 10, 25, 50)
Pagination cursor to fetch the next page of results
Sort order: ‘created_at_newest_first’ or ‘created_at_oldest_first’
How to combine filters: ‘all’ or ‘any’
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "incidents" : { "items" : { "additionalProperties" : true , "type" : "object" }, "title" : "Incidents" , "type" : "array" }, "pagination_meta" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Pagination Meta" } }, "required" : [ "success" ], "title" : "IncidentsListOutput" , "type" : "object" }
incidents_create — Create a new incident in incident.io. Requires idempotency_key, severity_id, and visibility. Optionally accepts name, summary, type, and status.
Parameters Unique identifier to prevent duplicate creation (e.g., a UUID)
Visibility of the incident: ‘public’ or ‘private’
Brief summary of the incident
ID of the initial incident status
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "incident" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Incident" } }, "required" : [ "success" ], "title" : "IncidentsCreateOutput" , "type" : "object" }
incidents_show — Retrieve detailed information about a specific incident by its ID, including custom fields and role assignments.
incidents_update — Update an existing incident in incident.io. Can update name, summary, severity, status, or type.
Parameters ID of the incident to update
Whether to notify the incident channel about this update
Updated name of the incident
Updated summary of the incident
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "incident" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Incident" } }, "required" : [ "success" ], "title" : "IncidentsUpdateOutput" , "type" : "object" }
actions_list — List actions from incident.io. Optionally filter by incident ID.
Parameters Filter actions by incident ID
Filter by incident mode: standard, retrospective, test, tutorial, or stream
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "actions" : { "items" : { "additionalProperties" : true , "type" : "object" }, "title" : "Actions" , "type" : "array" } }, "required" : [ "success" ], "title" : "ActionsListOutput" , "type" : "object" }
actions_show — Get detailed information about a specific action from incident.io.
follow_ups_list — List follow-ups from incident.io. Optionally filter by incident ID.
Parameters Filter follow-ups by incident ID
Filter by incident mode: standard, retrospective, test, tutorial, or stream
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "follow_ups" : { "items" : { "additionalProperties" : true , "type" : "object" }, "title" : "Follow Ups" , "type" : "array" } }, "required" : [ "success" ], "title" : "FollowUpsListOutput" , "type" : "object" }
follow_ups_show — Get detailed information about a specific follow-up from incident.io.
users_list — List all users in the incident.io workspace. Returns user details including id, name, email, and role.
Parameters Number of results to return per page (e.g., 10, 25, 50)
Pagination cursor to fetch the next page of results
Filter users by email address
Filter users by Slack user ID
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "users" : { "items" : { "additionalProperties" : true , "type" : "object" }, "title" : "Users" , "type" : "array" }, "pagination_meta" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Pagination Meta" } }, "required" : [ "success" ], "title" : "UsersListOutput" , "type" : "object" }
users_show — Get detailed information about a specific user by their ID.
workflows_list — List all workflows in the incident.io workspace.
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "workflows" : { "items" : { "additionalProperties" : true , "type" : "object" }, "title" : "Workflows" , "type" : "array" } }, "required" : [ "success" ], "title" : "WorkflowsListOutput" , "type" : "object" }
workflows_create — Create a new workflow in incident.io.
Parameters Folder to organize the workflow in
State of the workflow: active, draft, or disabled (Default: draft)
Trigger type for the workflow (Default: incident.updated)
Array of workflow steps (defaults to [])
Array of condition groups controlling when the workflow runs
When to run: newly_created, newly_created_and_active, active, or all (Default: newly_created)
Array of incident modes to run on (defaults to [‘standard’])
include_private_incidents
Whether to include private incidents (Default: true)
Whether to continue executing subsequent steps if one fails (Default: false)
Array of fields making the workflow run once per combination
Array of workflow expressions for advanced logic
Delay configuration object
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "workflow" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Workflow" }, "management_meta" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Management Meta" } }, "required" : [ "success" ], "title" : "WorkflowsCreateOutput" , "type" : "object" }
workflows_show — Get details of a specific workflow in incident.io.
Parameters The ID of the workflow to retrieve
Skip workflow step upgrades when existing step parameters changed
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "workflow" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Workflow" }, "management_meta" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Management Meta" } }, "required" : [ "success" ], "title" : "WorkflowsShowOutput" , "type" : "object" }
workflows_update — Update an existing workflow in incident.io.
Parameters The ID of the workflow to update
New name for the workflow
Complete array of workflow steps
Complete array of workflow condition groups
When to run: newly_created, newly_created_and_active, active, or all
Complete array of incident modes to run on
include_private_incidents
Whether to include private incidents
Whether to continue executing subsequent steps if one fails
Complete array of fields that make the workflow run once
Complete array of workflow expressions
New state: active, draft, or disabled
New folder for the workflow
Delay configuration object
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "workflow" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Workflow" }, "management_meta" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Management Meta" } }, "required" : [ "success" ], "title" : "WorkflowsUpdateOutput" , "type" : "object" }
workflows_delete — Delete a workflow in incident.io.
Parameters The ID of the workflow to delete
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "message" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Message" } }, "required" : [ "success" ], "title" : "WorkflowsDeleteOutput" , "type" : "object" }
schedules_list — List all schedules in incident.io.
Parameters Number of results to return per page (e.g., 10, 25, 50)
Pagination cursor to fetch the next page of results
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "schedules" : { "items" : { "additionalProperties" : true , "type" : "object" }, "title" : "Schedules" , "type" : "array" }, "pagination_meta" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Pagination Meta" } }, "required" : [ "success" ], "title" : "SchedulesListOutput" , "type" : "object" }
schedules_create — Create a new schedule in incident.io.
Parameters Timezone for the schedule (e.g., America/New_York)
Schedule configuration object with rotations
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "schedule" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Schedule" } }, "required" : [ "success" ], "title" : "SchedulesCreateOutput" , "type" : "object" }
schedules_show — Get details of a specific schedule in incident.io.
Parameters Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "schedule" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Schedule" } }, "required" : [ "success" ], "title" : "SchedulesShowOutput" , "type" : "object" }
schedules_update — Update an existing schedule in incident.io.
Parameters The ID of the schedule to update
New name for the schedule
New timezone for the schedule
Schedule configuration object with rotations
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "schedule" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Schedule" } }, "required" : [ "success" ], "title" : "SchedulesUpdateOutput" , "type" : "object" }
schedules_delete — Delete a schedule in incident.io.
Parameters The ID of the schedule to delete
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "message" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Message" } }, "required" : [ "success" ], "title" : "SchedulesDeleteOutput" , "type" : "object" }
escalations_list — List all escalations in incident.io.
Parameters Number of results to return per page (e.g., 10, 25, 50)
Pagination cursor to fetch the next page of results
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "escalations" : { "items" : { "additionalProperties" : true , "type" : "object" }, "title" : "Escalations" , "type" : "array" }, "pagination_meta" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Pagination Meta" } }, "required" : [ "success" ], "title" : "EscalationsListOutput" , "type" : "object" }
escalations_create — Create a new escalation in incident.io.
Parameters Unique identifier to prevent duplicate escalation creation
ID of the escalation path (required if user_ids not provided)
Comma-separated user IDs to notify (required if no escalation_path_id)
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "escalation" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Escalation" } }, "required" : [ "success" ], "title" : "EscalationsCreateOutput" , "type" : "object" }
escalations_show — Get details of a specific escalation in incident.io.
Parameters The ID of the escalation policy
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "escalation" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Escalation" } }, "required" : [ "success" ], "title" : "EscalationsShowOutput" , "type" : "object" }
custom_fields_list — List all custom fields from incident.io.
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "custom_fields" : { "items" : { "additionalProperties" : true , "type" : "object" }, "title" : "Custom Fields" , "type" : "array" } }, "required" : [ "success" ], "title" : "CustomFieldsListOutput" , "type" : "object" }
custom_fields_create — Create a new custom field in incident.io.
Parameters Description of the custom field
Field type: text, single_select, multi_select, numeric, link, etc.
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "custom_field" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Custom Field" } }, "required" : [ "success" ], "title" : "CustomFieldsCreateOutput" , "type" : "object" }
custom_fields_show — Get detailed information about a specific custom field from incident.io.
custom_fields_update — Update an existing custom field in incident.io.
Parameters New name for the custom field
New description for the custom field
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "custom_field" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Custom Field" } }, "required" : [ "success" ], "title" : "CustomFieldsUpdateOutput" , "type" : "object" }
custom_fields_delete — Delete a custom field from incident.io.
Parameters Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "message" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Message" } }, "required" : [ "success" ], "title" : "CustomFieldsDeleteOutput" , "type" : "object" }
severities_list — List all severity levels configured in the incident.io workspace.
incident_statuses_list — List all incident statuses configured in the incident.io workspace.
incident_types_list — List all incident types configured in the incident.io workspace.
incident_roles_list — List all incident roles in incident.io.
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "incident_roles" : { "items" : { "additionalProperties" : true , "type" : "object" }, "title" : "Incident Roles" , "type" : "array" } }, "required" : [ "success" ], "title" : "IncidentRolesListOutput" , "type" : "object" }
incident_roles_create — Create a new incident role in incident.io.
Parameters Name of the incident role
Description of the incident role
Instructions for the incident role
Short form abbreviation for the role
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "incident_role" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Incident Role" } }, "required" : [ "success" ], "title" : "IncidentRolesCreateOutput" , "type" : "object" }
incident_roles_show — Get details of a specific incident role in incident.io.
Parameters The ID of the incident role
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "incident_role" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Incident Role" } }, "required" : [ "success" ], "title" : "IncidentRolesShowOutput" , "type" : "object" }
incident_roles_update — Update an existing incident role in incident.io.
Parameters The ID of the incident role to update
Name of the incident role
Description of the incident role
Instructions for the incident role
Short form abbreviation for the role
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "incident_role" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Incident Role" } }, "required" : [ "success" ], "title" : "IncidentRolesUpdateOutput" , "type" : "object" }
incident_roles_delete — Delete an incident role in incident.io.
Parameters The ID of the incident role to delete
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "message" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Message" } }, "required" : [ "success" ], "title" : "IncidentRolesDeleteOutput" , "type" : "object" }
incident_timestamps_list — List all incident timestamp definitions in incident.io.
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "incident_timestamps" : { "items" : { "additionalProperties" : true , "type" : "object" }, "title" : "Incident Timestamps" , "type" : "array" } }, "required" : [ "success" ], "title" : "IncidentTimestampsListOutput" , "type" : "object" }
incident_timestamps_show — Get details of a specific incident timestamp definition in incident.io.
Parameters The ID of the incident timestamp
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "incident_timestamp" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Incident Timestamp" } }, "required" : [ "success" ], "title" : "IncidentTimestampsShowOutput" , "type" : "object" }
incident_updates_list — List incident updates in incident.io. Optionally filter by incident ID.
Parameters The ID of the incident to get updates for
Number of results to return per page (e.g., 10, 25, 50)
Pagination cursor to fetch the next page of results
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "incident_updates" : { "items" : { "additionalProperties" : true , "type" : "object" }, "title" : "Incident Updates" , "type" : "array" }, "pagination_meta" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Pagination Meta" } }, "required" : [ "success" ], "title" : "IncidentUpdatesListOutput" , "type" : "object" }
schedule_entries_list — List all entries for a specific schedule in incident.io.
Parameters The ID of the schedule to get entries for
Start of the filter window in ISO 8601 format
End of the filter window in ISO 8601 format
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "schedule_entries" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Schedule Entries" }, "pagination_meta" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Pagination Meta" } }, "required" : [ "success" ], "title" : "ScheduleEntriesListOutput" , "type" : "object" }
schedule_overrides_create — Create a new schedule override in incident.io.
Parameters The ID of the rotation to override
The ID of the layer this override applies to
When the override starts in ISO 8601 format
When the override ends in ISO 8601 format
The ID of the user to assign
The email of the user to assign
The Slack ID of the user to assign
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "override" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Override" } }, "required" : [ "success" ], "title" : "ScheduleOverridesCreateOutput" , "type" : "object" }
escalation_paths_list — List escalation paths in incident.io.
Parameters Number of results to return per page (e.g., 10, 25, 50)
Pagination cursor to fetch the next page of results
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "escalation_paths" : { "items" : { "additionalProperties" : true , "type" : "object" }, "title" : "Escalation Paths" , "type" : "array" }, "pagination_meta" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Pagination Meta" } }, "required" : [ "success" ], "title" : "EscalationPathsListOutput" , "type" : "object" }
escalation_paths_create — Create a new escalation path in incident.io.
Parameters Name of the escalation path
Array of escalation levels. Each level has targets (array of {id, type, schedule_id?, user_id?, urgency}) and time_to_ack_seconds
Optional working hours config: array of {weekday, start_time, end_time}
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "escalation_path" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Escalation Path" } }, "required" : [ "success" ], "title" : "EscalationPathsCreateOutput" , "type" : "object" }
escalation_paths_show — Get details of a specific escalation path in incident.io.
Parameters The ID of the escalation path
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "escalation_path" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Escalation Path" } }, "required" : [ "success" ], "title" : "EscalationPathsShowOutput" , "type" : "object" }
escalation_paths_update — Update an existing escalation path in incident.io.
Parameters The ID of the escalation path to update
New name for the escalation path
New escalation path: array of levels with targets and time_to_ack_seconds
New working hours config: array of {weekday, start_time, end_time}
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "escalation_path" : { "anyOf" : [ { "additionalProperties" : true , "type" : "object" }, { "type" : "null" } ], "default" : null , "title" : "Escalation Path" } }, "required" : [ "success" ], "title" : "EscalationPathsUpdateOutput" , "type" : "object" }
escalation_paths_delete — Delete an escalation path in incident.io.
Parameters The ID of the escalation path to delete
Response { "additionalProperties" : false , "properties" : { "success" : { "title" : "Success" , "type" : "boolean" }, "error" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Error" }, "message" : { "anyOf" : [ { "type" : "string" }, { "type" : "null" } ], "default" : null , "title" : "Message" } }, "required" : [ "success" ], "title" : "EscalationPathsDeleteOutput" , "type" : "object" }
Limits & Quotas
Rate limit : 1200 requests/minute per API key (default).Endpoints : most resources live under /v2; severities, incident
statuses, and incident types are served under /v1.Pagination : list endpoints accept page_size plus an after
cursor; the tools expose both as optional parameters and do not
auto-loop — pass the returned cursor to fetch the next page.Error model : non-2xx responses and timeouts are caught and returned
as success=False + error rather than raising. Plan retries on the
agent side based on the error string.
Links 
