列出事件(incidentio_incidents_list)
从 incident.io 列出事件。返回事件列表及其详细信息,包括严重性、状态和时间戳。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
page_size | number | 否 | 每页返回的事件数量 (默认值:25) |
after | string | 否 | 用于获取下一页结果的分页游标 |
输出
| 参数 | 类型 | 描述 |
|---|
incidents | array | 事件列表 |
pagination_meta | object | 分页元数据 |
创建事件 (incidentio_incidents_create)
在 incident.io 中创建新事件。需要 idempotency_key、severity_id 和 visibility。可选接受 name、summary、type 和 status。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
idempotency_key | string | 是 | 用于防止重复创建事件的唯一标识符。请使用 UUID 或唯一字符串。 |
name | string | 否 | 事件名称 (可选) |
summary | string | 否 | 事件简要摘要 |
severity_id | string | 是 | 严重级别 ID (必填) |
incident_type_id | string | 否 | 事件类型 ID |
incident_status_id | string | 否 | 初始事件状态 ID |
visibility | string | 是 | 事件可见性:"public" 或 "private" (必填) |
输出
| 参数 | 类型 | 描述 |
|---|
incident | object | 已创建的事件对象 |
显示事件(incidentio_incidents_show)
根据其 ID 从 incident.io 获取特定事件的详细信息。返回完整的事件详情,包括自定义字段和角色分配。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 要获取的事件 ID |
输出
| 参数 | 类型 | 描述 |
|---|
incident | object | 详细事件信息 |
更新事件 (incidentio_incidents_update)
更新 incident.io 中的现有事件。可以更新名称、摘要、严重性、状态或类型。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 要更新的事件 ID |
name | string | 否 | 事件的新名称 |
summary | string | 否 | 事件的新摘要 |
severity_id | string | 否 | 事件的新严重性 ID |
incident_status_id | string | 否 | 事件的新状态 ID |
incident_type_id | string | 否 | 事件的新类型 ID |
notify_incident_channel | boolean | 是 | 是否就此次更新通知事件渠道 |
输出
| 参数 | 类型 | 说明 |
|---|
incident | object | 更新后的事件对象 |
列出操作 (incidentio_actions_list)
从 incident.io 列出操作。可选按事件 ID 筛选。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | 字符串 | 是 | incident.io API 密钥 |
incident_id | 字符串 | 否 | 按事件 ID 筛选操作 |
page_size | 数字 | 否 | 每页返回的操作数量 |
输出
查看操作(incidentio_actions_show)
获取 incident.io 中特定操作的详细信息。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 操作 ID |
输出
列出跟进事项(incidentio_follow_ups_list)
列出 incident.io 的跟进事项。可选按事件 ID 筛选。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
incident_id | string | 否 | 按事件 ID 筛选跟进事项 |
page_size | number | 否 | 每页返回的跟进事项数量 |
输出
| 参数 | 类型 | 描述 |
|---|
follow_ups | array | 跟进列表 |
显示跟进 (incidentio_follow_ups_show)
从 incident.io 获取特定跟进的详细信息。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | 字符串 | 是 | incident.io API 密钥 |
id | 字符串 | 是 | 跟进 ID |
输出
| 参数 | 类型 | 描述 |
|---|
follow_up | object | 跟进详情 |
列出用户(incidentio_users_list)
列出 Incident.io 工作区中的所有用户。返回用户详情,包括 id、name、email 和 role。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | Incident.io API 密钥 |
page_size | number | 否 | 每页返回的结果数 (默认:25) |
输出
| 参数 | 类型 | 说明 |
|---|
users | array | 工作区中的用户列表 |
显示用户 (incidentio_users_show)
通过 ID 获取 Incident.io 工作区中特定用户的详细信息。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | Incident.io API 密钥 |
id | string | 是 | 要获取的用户的唯一标识符 |
输出
| 参数 | 类型 | 说明 |
|---|
user | object | 所请求用户的详细信息 |
列出工作流(incidentio_workflows_list)
列出 incident.io 工作区中的所有工作流。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | 字符串 | 是 | incident.io API 密钥 |
page_size | 数字 | 否 | 每页返回的工作流数量 |
after | 字符串 | 否 | 用于获取下一页结果的分页游标 |
输出
| 参数 | 类型 | 描述 |
|---|
workflows | 数组 | 工作流列表 |
pagination_meta | 对象 | 分页元数据 |
查看工作流 (incidentio_workflows_show)
获取 incident.io 中特定工作流的详情。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 要检索的工作流 ID |
输出
更新工作流(incidentio_workflows_update)
更新 incident.io 中现有的工作流。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 要更新的工作流 ID |
name | string | 否 | 工作流的新名称 |
state | string | 否 | 工作流的新状态 (active、draft 或 disabled) |
folder | string | 否 | 工作流的新文件夹 |
输出
| 参数 | 类型 | 说明 |
|---|
workflow | object | 更新后的工作流 |
删除工作流 (incidentio_workflows_delete)
在 incident.io 中删除工作流。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 要删除的工作流 ID |
输出
列出排班 (incidentio_schedules_list)
列出 incident.io 中的所有排班
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
page_size | number | 否 | 每页结果数量 (默认:25) |
after | string | 否 | 用于获取下一页结果的分页游标 |
输出
| 参数 | 类型 | 说明 |
|---|
schedules | array | 排班列表 |
pagination_meta | object | 分页元数据 |
排班配置*
包含轮班的 JSON 配置。示例:{"rotations": [{"name": "Primary", "users": [{"id": "user_id"}], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": [{"interval": 1, "interval_type": "weekly"}]}]}
创建排班 (incidentio_schedules_create)
在 incident.io 中创建新排班
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
name | string | 是 | 排班名称 |
timezone | string | 是 | 排班的时区 (例如 America/New_York) |
config | string | 是 | 排班配置,为包含轮换的 JSON 字符串。示例:{"rotations": [{"name": "Primary", "users": [{"id": "user_id"}], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": [{"interval": 1, "interval_type": "weekly"}]}]} |
输出
| 参数 | 类型 | 描述 |
|---|
schedule | object | 创建的排班 |
显示排班表 (incidentio_schedules_show)
获取 incident.io 中特定排班表的详细信息
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 排班表的 ID |
输出
| 参数 | 类型 | 描述 |
|---|
schedule | object | 排班表的详细信息 |
更新排班 (incidentio_schedules_update)
更新 incident.io 中的现有排班
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | 字符串 | 是 | incident.io API 密钥 |
id | 字符串 | 是 | 要更新的排班 ID |
name | 字符串 | 否 | 排班的新名称 |
timezone | 字符串 | 否 | 排班的新时区(例如 America/New_York) |
config | 字符串 | 否 | 排班配置,为包含轮换的 JSON 字符串。示例:{"rotations": [{"name": "Primary", "users": [{"id": "user_id"}], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": [{"interval": 1, "interval_type": "weekly"}]}]} |
输出
删除排班表(incidentio_schedules_delete)
删除 incident.io 中的排班表
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 要删除的排班表 ID |
输出
列出升级(incidentio_escalations_list)
列出 incident.io 中的所有升级策略
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
page_size | number | 否 | 每页结果数 (默认:25) |
输出
| 参数 | 类型 | 描述 |
|---|
escalations | array | 升级策略列表 |
升级路径 ID
输入升级路径 ID(如果无用户 ID 则必填)...
用户 ID
输入用户 ID,以逗号分隔(如果无路径 ID 则必填)...
创建升级(incidentio_escalations_create)
在 incident.io 中创建新的升级策略
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
idempotency_key | string | 是 | 唯一标识符,用于防止重复创建升级。请使用 UUID 或唯一字符串。 |
title | string | 是 | 升级的标题 |
escalation_path_id | string | 否 | 要使用的升级路径 ID (未提供 user_ids 时必填) |
user_ids | string | 否 | 逗号分隔的待通知用户 ID 列表 (未提供 escalation_path_id 时必填) |
输出
| 参数 | 类型 | 说明 |
|---|
escalation | object | 已创建的升级策略 |
查看升级策略(incidentio_escalations_show)
获取 incident.io 中特定升级策略的详细信息
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 升级策略的 ID |
输出
| 参数 | 类型 | 说明 |
|---|
escalation | object | 升级策略的详细信息 |
列出自定义字段 (incidentio_custom_fields_list)
列出 incident.io 中的所有自定义字段。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
输出
| 参数 | 类型 | 说明 |
|---|
custom_fields | array | 自定义字段列表 |
创建自定义字段 (incidentio_custom_fields_create)
在 incident.io 中创建新的自定义字段。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
name | string | 是 | 自定义字段的名称 |
description | string | 是 | 自定义字段的说明 (必填) |
field_type | string | 是 | 自定义字段的类型 (例如:text、single_select、multi_select、numeric、datetime、link、user、team) |
输出
| 参数 | 类型 | 说明 |
|---|
custom_field | object | 已创建的自定义字段 |
查看自定义字段 (incidentio_custom_fields_show)
获取 incident.io 中特定自定义字段的详细信息。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 自定义字段 ID |
输出
| 参数 | 类型 | 描述 |
|---|
custom_field | object | 自定义字段详情 |
更新自定义字段 (incidentio_custom_fields_update)
更新 incident.io 中的现有自定义字段。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | 字符串 | 是 | incident.io API 密钥 |
id | 字符串 | 是 | 自定义字段 ID |
name | 字符串 | 是 | 自定义字段的新名称(必填) |
description | 字符串 | 是 | 自定义字段的新描述(必填) |
输出
| 参数 | 类型 | 说明 |
|---|
custom_field | 对象 | 更新后的自定义字段 |
删除自定义字段 (incidentio_custom_fields_delete)
从 incident.io 删除自定义字段。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 自定义字段 ID |
输出
列出严重级别(incidentio_severities_list)
列出 Incident.io 工作区中配置的所有严重级别。返回严重级别的详细信息,包括 id、name、description 和 rank。
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | Incident.io API 密钥 |
输出
| 参数 | 类型 | 说明 |
|---|
severities | array | 严重级别列表 |
列出事件状态 (incidentio_incident_statuses_list)
列出 Incident.io 工作区中配置的所有事件状态。返回状态详情,包括 id、name、description 和 category。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | Incident.io API 密钥 |
输出
| 参数 | 类型 | 描述 |
|---|
incident_statuses | array | 事件状态列表 |
列出事件类型(incidentio_incident_types_list)
列出 Incident.io 工作区中配置的所有事件类型。返回类型详情,包括 id、name、description 和默认标志。
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | Incident.io API 密钥 |
输出
| 参数 | 类型 | 描述 |
|---|
incident_types | array | 事件类型列表 |
列出事件角色 (incidentio_incident_roles_list)
列出 incident.io 中的所有事件角色
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
输出
| 参数 | 类型 | 描述 |
|---|
incident_roles | array | 事件角色列表 |
简称*
输入简写形式(例如 INC、LEAD)...
创建事件角色 (incidentio_incident_roles_create)
在 incident.io 中创建新的事件角色
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
name | string | 是 | 事件角色的名称 |
description | string | 是 | 事件角色的描述 |
instructions | string | 是 | 事件角色的说明 |
shortform | string | 是 | 角色的简称 |
输出
| 参数 | 类型 | 描述 |
|---|
incident_role | object | 创建的事件角色 |
显示事件角色 (incidentio_incident_roles_show)
获取 incident.io 中特定事件角色的详细信息
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | 字符串 | 是 | incident.io API 密钥 |
id | 字符串 | 是 | 事件角色的 ID |
输出
| 参数 | 类型 | 描述 |
|---|
incident_role | 对象 | 事件角色的详细信息 |
缩写*
输入缩写形式(例如:INC, LEAD)...
更新事件角色(incidentio_incident_roles_update)
在 incident.io 中更新现有事件角色
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 要更新的事件角色 ID |
name | string | 是 | 事件角色名称 |
description | string | 是 | 事件角色说明 |
instructions | string | 是 | 事件角色的处理指引 |
shortform | string | 是 | 该角色的简称 |
输出
| 参数 | 类型 | 说明 |
|---|
incident_role | object | 更新后的事件角色 |
删除事件角色(incidentio_incident_roles_delete)
在 incident.io 中删除事件角色
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 要删除的事件角色 ID |
输出
列出事件时间戳 (incidentio_incident_timestamps_list)
列出 incident.io 中的所有事件时间戳定义
输入
| 参数 | 类型 | 必需 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
输出
| 参数 | 类型 | 描述 |
|---|
incident_timestamps | 数组 | 事件时间戳定义列表 |
显示事件时间戳(incidentio_incident_timestamps_show)
获取 incident.io 中特定事件时间戳定义的详细信息
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 事件时间戳的 ID |
输出
| 参数 | 类型 | 描述 |
|---|
incident_timestamp | object | 事件时间戳详情 |
事件 ID
输入事件 ID(可选 - 留空以包含所有事件)...
列出事件更新 (incidentio_incident_updates_list)
列出 incident.io 中特定事件的所有更新
输入
| 参数 | 类型 | 必需 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
incident_id | string | 否 | 要获取更新的事件 ID (可选 - 如果未提供,则返回所有更新) |
page_size | number | 否 | 每页返回的结果数 |
after | string | 否 | 分页游标 |
输出
| 参数 | 类型 | 描述 |
|---|
incident_updates | array | 事件更新列表 |
pagination_meta | object | 分页信息 |
条目窗口开始时间(日期/时间)
例如:2024-01-01 00:00:00...
条目窗口结束时间(日期/时间)
2024-12-31 23:59:59...
列出排班条目 (incidentio_schedule_entries_list)
列出 incident.io 中指定排班的所有条目
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
schedule_id | string | 是 | 要获取条目的排班 ID |
entry_window_start | string | 否 | 筛选条目的开始日期/时间(ISO 8601 格式) |
entry_window_end | string | 否 | 筛选条目的结束日期/时间(ISO 8601 格式) |
page_size | number | 否 | 每页返回的结果数 |
after | string | 否 | 分页游标 |
输出
| 参数 | 类型 | 描述 |
|---|
schedule_entries | array | 排班条目列表 |
pagination_meta | object | 分页信息 |
用户 ID
输入用户 ID(提供以下之一:user_id、user_email 或 user_slack_id)...
用户邮箱
输入用户邮箱(提供以下之一:user_id、user_email 或 user_slack_id)...
用户 Slack ID
输入用户 Slack ID(提供以下之一:user_id、user_email 或 user_slack_id)...
开始时间*
例如:2024-01-01 00:00:00...
结束时间*
2024-12-31 23:59:59...
创建排班覆盖(incidentio_schedule_overrides_create)
在 incident.io 中创建新的排班覆盖
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
rotation_id | string | 是 | 要覆盖的轮值 ID |
schedule_id | string | 是 | 排班 ID |
user_id | string | 否 | 要分配的用户的 ID(请提供以下之一:user_id、user_email 或 user_slack_id) |
user_email | string | 否 | 要分配的用户的邮箱(请提供以下之一:user_id、user_email 或 user_slack_id) |
user_slack_id | string | 否 | 要分配的用户的 Slack ID(请提供以下之一:user_id、user_email 或 user_slack_id) |
start_at | string | 是 | 覆盖开始时间(ISO 8601 格式) |
end_at | string | 是 | 覆盖结束时间(ISO 8601 格式) |
输出
| 参数 | 类型 | 说明 |
|---|
override | object | 创建的排班覆盖 |
路径配置*
升级层级的 JSON 数组:[{"targets": [{"id": "...", "type": "...", "urgency": "..."}], "time_to_ack_seconds": 300}]
工作时间
可选的 JSON 数组:[{"weekday": "monday", "start_time": "09:00:00", "end_time": "17:00:00"}]
创建升级路径 (incidentio_escalation_paths_create)
在 incident.io 中创建新的升级路径
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
name | string | 是 | 升级路径的名称 |
path | json | 是 | 包含目标和确认时间(秒)的升级级别数组。每个级别应包含:targets (由 {id, type, schedule_id?, user_id?, urgency} 组成的数组) 和 time_to_ack_seconds (数字) |
working_hours | json | 否 | 可选的工作时间配置。由 {weekday, start_time, end_time} 组成的数组 |
输出
| 参数 | 类型 | 描述 |
|---|
escalation_path | object | 创建的升级路径 |
查看升级路径 (incidentio_escalation_paths_show)
获取 incident.io 中特定升级路径的详情
输入
| 参数 | 类型 | 必填 | 说明 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 升级路径的 ID |
输出
| 参数 | 类型 | 说明 |
|---|
escalation_path | object | 升级路径详情 |
路径配置
升级级别的 JSON 数组(更新时可选):[{"targets": [{"id": "...", "type": "...", "urgency": "..."}], "time_to_ack_seconds": 300}]
工作时间
可选 JSON 数组:[{"weekday": "monday", "start_time": "09:00:00", "end_time": "17:00:00"}]
更新升级路径 (incidentio_escalation_paths_update)
更新 incident.io 中的现有升级路径
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | Yes | incident.io API 密钥 |
id | string | Yes | 要更新的升级路径 ID |
name | string | No | 升级路径的新名称 |
path | json | No | 新的升级路径配置。包含目标和 time_to_ack_seconds 的升级级别数组 |
working_hours | json | No | 新的工作时间配置。{weekday, start_time, end_time} 数组 |
输出
| 参数 | 类型 | 描述 |
|---|
escalation_path | object | 更新后的升级路径 |
删除升级路径 (incidentio_escalation_paths_delete)
在 incident.io 中删除升级路径
输入
| 参数 | 类型 | 必填 | 描述 |
|---|
apiKey | string | 是 | incident.io API 密钥 |
id | string | 是 | 要删除的升级路径的 ID |
输出
将 incident.io 集成到工作流中。管理事件、行动、跟进、工作流、时间表、升级、自定义字段等。