incident.io Integration

Field	Description	Required	Format
incident.io API Key	Your incident.io API key from Settings -> API keys	Yes	`-`

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

Parameters

integer

Number of results to return per page (e.g., 10, 25, 50)

string

Pagination cursor to fetch the next page of results

string

Sort order: ‘created_at_newest_first’ or ‘created_at_oldest_first’

string

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

string

required

Unique identifier to prevent duplicate creation (e.g., a UUID)

string

required

ID of the severity level

string

required

Visibility of the incident: ‘public’ or ‘private’

string

Name of the incident

string

Brief summary of the incident

string

ID of the incident type

string

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.

Parameters

string

required

ID of the incident to retrieve

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": "IncidentsShowOutput",
  "type": "object"
}

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

Parameters

string

required

ID of the incident to update

boolean

required

Whether to notify the incident channel about this update

string

Updated name of the incident

string

Updated summary of the incident

string

Updated severity ID

string

Updated status ID

string

Updated incident type ID

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

string

Filter actions by incident ID

string

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.

Parameters

string

required

Action ID

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "action": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Action"
    }
  },
  "required": [
    "success"
  ],
  "title": "ActionsShowOutput",
  "type": "object"
}

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

Parameters

string

Filter follow-ups by incident ID

string

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.

Parameters

string

required

Follow-up ID

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "follow_up": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Follow Up"
    }
  },
  "required": [
    "success"
  ],
  "title": "FollowUpsShowOutput",
  "type": "object"
}

users_list — List all users in the incident.io workspace. Returns user details including id, name, email, and role.

Parameters

integer

Number of results to return per page (e.g., 10, 25, 50)

string

Pagination cursor to fetch the next page of results

string

Filter users by email address

string

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.

Parameters

string

required

The unique identifier of the user to retrieve

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "user": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "User"
    }
  },
  "required": [
    "success"
  ],
  "title": "UsersShowOutput",
  "type": "object"
}

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

string

required

Name of the workflow

string

Folder to organize the workflow in

string

State of the workflow: active, draft, or disabled (Default: draft)

string

Trigger type for the workflow (Default: incident.updated)

array

Array of workflow steps (defaults to [])

array

Array of condition groups controlling when the workflow runs

string

When to run: newly_created, newly_created_and_active, active, or all (Default: newly_created)

array

Array of incident modes to run on (defaults to [‘standard’])

boolean

Whether to include private incidents (Default: true)

boolean

Whether to continue executing subsequent steps if one fails (Default: false)

array

Array of fields making the workflow run once per combination

array

Array of workflow expressions for advanced logic

object

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

string

required

The ID of the workflow to retrieve

boolean

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

string

required

The ID of the workflow to update

string

required

New name for the workflow

array

required

Complete array of workflow steps

array

required

Complete array of workflow condition groups

string

required

When to run: newly_created, newly_created_and_active, active, or all

array

required

Complete array of incident modes to run on

boolean

required

Whether to include private incidents

boolean

required

Whether to continue executing subsequent steps if one fails

array

required

Complete array of fields that make the workflow run once

array

required

Complete array of workflow expressions

string

New state: active, draft, or disabled

string

New folder for the workflow

object

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

string

required

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

integer

Number of results to return per page (e.g., 10, 25, 50)

string

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

string

required

Name of the schedule

string

required

Timezone for the schedule (e.g., America/New_York)

object

required

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

string

required

The ID of the schedule

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

string

required

The ID of the schedule to update

string

New name for the schedule

string

New timezone for the schedule

object

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

string

required

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

integer

Number of results to return per page (e.g., 10, 25, 50)

string

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

string

required

Unique identifier to prevent duplicate escalation creation

string

required

Title of the escalation

string

ID of the escalation path (required if user_ids not provided)

string

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

string

required

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

string

required

Name of the custom field

string

required

Description of the custom field

string

required

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.

Parameters

string

required

Custom field ID

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": "CustomFieldsShowOutput",
  "type": "object"
}

custom_fields_update — Update an existing custom field in incident.io.

Parameters

string

required

Custom field ID

string

required

New name for the custom field

string

required

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

string

required

Custom field ID

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.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "severities": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Severities",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "SeveritiesListOutput",
  "type": "object"
}

incident_statuses_list — List all incident statuses configured in the incident.io workspace.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "incident_statuses": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Incident Statuses",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "IncidentStatusesListOutput",
  "type": "object"
}

incident_types_list — List all incident types configured in the incident.io workspace.

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "incident_types": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Incident Types",
      "type": "array"
    }
  },
  "required": [
    "success"
  ],
  "title": "IncidentTypesListOutput",
  "type": "object"
}

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

string

required

Name of the incident role

string

required

Description of the incident role

string

required

Instructions for the incident role

string

required

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

string

required

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

string

required

The ID of the incident role to update

string

required

Name of the incident role

string

required

Description of the incident role

string

required

Instructions for the incident role

string

required

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

string

required

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

string

required

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

string

The ID of the incident to get updates for

integer

Number of results to return per page (e.g., 10, 25, 50)

string

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

string

required

The ID of the schedule to get entries for

string

Start of the filter window in ISO 8601 format

string

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

string

required

The ID of the rotation to override

string

required

The ID of the layer this override applies to

string

required

The ID of the schedule

string

required

When the override starts in ISO 8601 format

string

required

When the override ends in ISO 8601 format

string

The ID of the user to assign

string

The email of the user to assign

string

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

integer

Number of results to return per page (e.g., 10, 25, 50)

string

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

string

required

Name of the escalation path

array

required

Array of escalation levels. Each level has targets (array of {id, type, schedule_id?, user_id?, urgency}) and time_to_ack_seconds

array

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

string

required

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

string

required

The ID of the escalation path to update

string

required

New name for the escalation path

array

required

New escalation path: array of levels with targets and time_to_ack_seconds

array

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

string

required

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

​Overview

​Authentication

​API Key Authentication

​Required Credentials

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Response

​Response

​Response

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

Overview

Authentication

API Key Authentication

Required Credentials

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Response

Response

Response

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Response

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response