incidentio

使用 incident.io 管理事件

配置

列出事件

操作
列出事件
API 密钥*
••••••••
分页大小
25
之后(分页)
分页游标
列出事件(incidentio_incidents_list)

从 incident.io 列出事件。返回事件列表及其详细信息,包括严重性、状态和时间戳。

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
page_sizenumber否每页返回的事件数量 (默认值:25)
afterstring否用于获取下一页结果的分页游标
输出
参数类型描述
incidentsarray事件列表
pagination_metaobject分页元数据

创建事件

操作
创建事件
API 密钥*
••••••••
事件名称
输入事件名称...
摘要
输入事件摘要...
严重性 ID*
输入严重性 ID...
事件类型 ID
输入事件类型 ID...
事件状态 ID
输入事件状态 ID...
可见性*
公开
幂等键*
输入唯一键(例如 UUID)
创建事件 (incidentio_incidents_create)

在 incident.io 中创建新事件。需要 idempotency_key、severity_id 和 visibility。可选接受 name、summary、type 和 status。

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
idempotency_keystring是用于防止重复创建事件的唯一标识符。请使用 UUID 或唯一字符串。
namestring否事件名称 (可选)
summarystring否事件简要摘要
severity_idstring是严重级别 ID (必填)
incident_type_idstring否事件类型 ID
incident_status_idstring否初始事件状态 ID
visibilitystring是事件可见性:"public" 或 "private" (必填)
输出
参数类型描述
incidentobject已创建的事件对象

查看事件

操作
查看事件
API 密钥*
••••••••
ID*
输入 ID...
显示事件(incidentio_incidents_show)

根据其 ID 从 incident.io 获取特定事件的详细信息。返回完整的事件详情,包括自定义字段和角色分配。

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
idstring是要获取的事件 ID
输出
参数类型描述
incidentobject详细事件信息

更新事件

操作
更新事件
API 密钥*
••••••••
摘要
输入事件摘要...
严重级别 ID
输入严重级别 ID...
事件类型 ID
输入事件类型 ID...
事件状态 ID
输入事件状态 ID...
通知事件频道*
Disabled
ID*
输入 ID...
名称
输入名称...
更新事件 (incidentio_incidents_update)

更新 incident.io 中的现有事件。可以更新名称、摘要、严重性、状态或类型。

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
idstring是要更新的事件 ID
namestring否事件的新名称
summarystring否事件的新摘要
severity_idstring否事件的新严重性 ID
incident_status_idstring否事件的新状态 ID
incident_type_idstring否事件的新类型 ID
notify_incident_channelboolean是是否就此次更新通知事件渠道
输出
参数类型说明
incidentobject更新后的事件对象

列出操作

操作
列出操作
API 密钥*
••••••••
每页数量
25
事件 ID
按事件 ID 筛选...
列出操作 (incidentio_actions_list)

从 incident.io 列出操作。可选按事件 ID 筛选。

输入
参数类型必填说明
apiKey字符串是incident.io API 密钥
incident_id字符串否按事件 ID 筛选操作
page_size数字否每页返回的操作数量
输出
参数类型描述
actionsarray操作列表

查看操作

操作
查看操作
API 密钥*
••••••••
ID*
输入 ID...
查看操作(incidentio_actions_show)

获取 incident.io 中特定操作的详细信息。

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
idstring是操作 ID
输出
参数类型描述
actionobject操作详情

列出跟进项

操作
列出跟进
API 密钥*
••••••••
分页大小
25
事件 ID
按事件 ID 过滤...
列出跟进事项(incidentio_follow_ups_list)

列出 incident.io 的跟进事项。可选按事件 ID 筛选。

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
incident_idstring否按事件 ID 筛选跟进事项
page_sizenumber否每页返回的跟进事项数量
输出
参数类型描述
follow_upsarray跟进列表

查看跟进事项

操作
查看跟进
API 密钥*
••••••••
ID*
输入 ID...
显示跟进 (incidentio_follow_ups_show)

从 incident.io 获取特定跟进的详细信息。

输入
参数类型必填描述
apiKey字符串是incident.io API 密钥
id字符串是跟进 ID
输出
参数类型描述
follow_upobject跟进详情

列出用户

操作
列出用户
API 密钥*
••••••••
每页数量
25
列出用户(incidentio_users_list)

列出 Incident.io 工作区中的所有用户。返回用户详情,包括 id、name、email 和 role。

输入
参数类型必填说明
apiKeystring是Incident.io API 密钥
page_sizenumber否每页返回的结果数 (默认:25)
输出
参数类型说明
usersarray工作区中的用户列表

查看用户

操作
查看用户
API 密钥*
••••••••
ID*
输入 ID...
显示用户 (incidentio_users_show)

通过 ID 获取 Incident.io 工作区中特定用户的详细信息。

输入
参数类型必填说明
apiKeystring是Incident.io API 密钥
idstring是要获取的用户的唯一标识符
输出
参数类型说明
userobject所请求用户的详细信息

列出工作流

操作
列出工作流
API 密钥*
••••••••
每页数量
25
After(分页)
分页游标
列出工作流(incidentio_workflows_list)

列出 incident.io 工作区中的所有工作流。

输入
参数类型必填描述
apiKey字符串是incident.io API 密钥
page_size数字否每页返回的工作流数量
after字符串否用于获取下一页结果的分页游标
输出
参数类型描述
workflows数组工作流列表
pagination_meta对象分页元数据

查看工作流

操作
查看工作流
API 密钥*
••••••••
ID*
输入 ID...
查看工作流 (incidentio_workflows_show)

获取 incident.io 中特定工作流的详情。

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
idstring是要检索的工作流 ID
输出
参数类型描述
workflow对象工作流详情

更新工作流

操作
更新工作流
API 密钥*
••••••••
ID*
输入 ID...
名称
输入名称...
文件夹
输入文件夹名称...
状态
活跃
更新工作流(incidentio_workflows_update)

更新 incident.io 中现有的工作流。

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
idstring是要更新的工作流 ID
namestring否工作流的新名称
statestring否工作流的新状态 (active、draft 或 disabled)
folderstring否工作流的新文件夹
输出
参数类型说明
workflowobject更新后的工作流

删除工作流

操作
删除工作流
API 密钥*
••••••••
ID*
输入 ID...
删除工作流 (incidentio_workflows_delete)

在 incident.io 中删除工作流。

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
idstring是要删除的工作流 ID
输出
参数类型说明
messagestring成功消息

列出排班

操作
列出排班
API 密钥*
••••••••
每页数量
25
After(分页)
分页游标
列出排班 (incidentio_schedules_list)

列出 incident.io 中的所有排班

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
page_sizenumber否每页结果数量 (默认:25)
afterstring否用于获取下一页结果的分页游标
输出
参数类型说明
schedulesarray排班列表
pagination_metaobject分页元数据

创建排班

操作
创建排班
API 密钥*
••••••••
名称*
输入名称...
时区*
Select...
排班配置*
包含轮班的 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 中创建新排班

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
namestring是排班名称
timezonestring是排班的时区 (例如 America/New_York)
configstring是排班配置,为包含轮换的 JSON 字符串。示例:{"rotations": [{"name": "Primary", "users": [{"id": "user_id"}], "handover_start_at": "2024-01-01T09:00:00Z", "handovers": [{"interval": 1, "interval_type": "weekly"}]}]}
输出
参数类型描述
scheduleobject创建的排班

查看排班

操作
查看排班
API 密钥*
••••••••
ID*
输入 ID...
显示排班表 (incidentio_schedules_show)

获取 incident.io 中特定排班表的详细信息

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
idstring是排班表的 ID
输出
参数类型描述
scheduleobject排班表的详细信息

更新排班表

操作
更新排班表
API 密钥*
••••••••
ID*
输入 ID...
名称
输入名称...
时区
Select...
更新排班 (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"}]}]}
输出
参数类型描述
schedule对象更新后的排班

删除排班

操作
删除排班
API 密钥*
••••••••
ID*
输入 ID...
删除排班表(incidentio_schedules_delete)

删除 incident.io 中的排班表

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
idstring是要删除的排班表 ID
输出
参数类型描述
messagestring成功消息

列出升级

操作
列出升级
API 密钥*
••••••••
每页数量
25
列出升级(incidentio_escalations_list)

列出 incident.io 中的所有升级策略

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
page_sizenumber否每页结果数 (默认:25)
输出
参数类型描述
escalationsarray升级策略列表

创建升级

操作
创建升级
API 密钥*
••••••••
幂等键*
输入唯一键(例如 UUID)...
标题*
输入升级标题...
升级路径 ID
输入升级路径 ID(如果无用户 ID 则必填)...
用户 ID
输入用户 ID,以逗号分隔(如果无路径 ID 则必填)...
创建升级(incidentio_escalations_create)

在 incident.io 中创建新的升级策略

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
idempotency_keystring是唯一标识符,用于防止重复创建升级。请使用 UUID 或唯一字符串。
titlestring是升级的标题
escalation_path_idstring否要使用的升级路径 ID (未提供 user_ids 时必填)
user_idsstring否逗号分隔的待通知用户 ID 列表 (未提供 escalation_path_id 时必填)
输出
参数类型说明
escalationobject已创建的升级策略

查看升级

操作
查看升级
API 密钥*
••••••••
ID*
输入 ID...
查看升级策略(incidentio_escalations_show)

获取 incident.io 中特定升级策略的详细信息

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
idstring是升级策略的 ID
输出
参数类型说明
escalationobject升级策略的详细信息

列出自定义字段

操作
列出自定义字段
API 密钥*
••••••••
列出自定义字段 (incidentio_custom_fields_list)

列出 incident.io 中的所有自定义字段。

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
输出
参数类型说明
custom_fieldsarray自定义字段列表

创建自定义字段

操作
创建自定义字段
API 密钥*
••••••••
名称*
输入名称...
描述*
输入描述...
字段类型*
文本
创建自定义字段 (incidentio_custom_fields_create)

在 incident.io 中创建新的自定义字段。

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
namestring是自定义字段的名称
descriptionstring是自定义字段的说明 (必填)
field_typestring是自定义字段的类型 (例如:text、single_select、multi_select、numeric、datetime、link、user、team)
输出
参数类型说明
custom_fieldobject已创建的自定义字段

查看自定义字段

操作
查看自定义字段
API 密钥*
••••••••
ID*
输入 ID...
查看自定义字段 (incidentio_custom_fields_show)

获取 incident.io 中特定自定义字段的详细信息。

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
idstring是自定义字段 ID
输出
参数类型描述
custom_fieldobject自定义字段详情

更新自定义字段

操作
更新自定义字段
API 密钥*
••••••••
ID*
输入 ID...
名称*
输入名称...
描述*
输入描述...
更新自定义字段 (incidentio_custom_fields_update)

更新 incident.io 中的现有自定义字段。

输入
参数类型必填说明
apiKey字符串是incident.io API 密钥
id字符串是自定义字段 ID
name字符串是自定义字段的新名称(必填)
description字符串是自定义字段的新描述(必填)
输出
参数类型说明
custom_field对象更新后的自定义字段

删除自定义字段

操作
删除自定义字段
API 密钥*
••••••••
ID*
输入 ID...
删除自定义字段 (incidentio_custom_fields_delete)

从 incident.io 删除自定义字段。

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
idstring是自定义字段 ID
输出
参数类型说明
messagestring成功消息

列出严重级别

操作
列出严重级别
API 密钥*
••••••••
列出严重级别(incidentio_severities_list)

列出 Incident.io 工作区中配置的所有严重级别。返回严重级别的详细信息,包括 id、name、description 和 rank。

输入
参数类型必填说明
apiKeystring是Incident.io API 密钥
输出
参数类型说明
severitiesarray严重级别列表

列出事故状态

操作
列出事故状态
API 密钥*
••••••••
列出事件状态 (incidentio_incident_statuses_list)

列出 Incident.io 工作区中配置的所有事件状态。返回状态详情,包括 id、name、description 和 category。

输入
参数类型必填描述
apiKeystring是Incident.io API 密钥
输出
参数类型描述
incident_statusesarray事件状态列表

列出事件类型

操作
列出事件类型
API 密钥*
••••••••
列出事件类型(incidentio_incident_types_list)

列出 Incident.io 工作区中配置的所有事件类型。返回类型详情,包括 id、name、description 和默认标志。

输入
参数类型必填描述
apiKeystring是Incident.io API 密钥
输出
参数类型描述
incident_typesarray事件类型列表

列出事件角色

操作
列出事件角色
API 密钥*
••••••••
列出事件角色 (incidentio_incident_roles_list)

列出 incident.io 中的所有事件角色

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
输出
参数类型描述
incident_rolesarray事件角色列表

创建事件角色

操作
创建事件角色
API 密钥*
••••••••
名称*
输入名称...
描述*
输入描述...
说明*
输入该角色的说明...
简称*
输入简写形式(例如 INC、LEAD)...
创建事件角色 (incidentio_incident_roles_create)

在 incident.io 中创建新的事件角色

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
namestring是事件角色的名称
descriptionstring是事件角色的描述
instructionsstring是事件角色的说明
shortformstring是角色的简称
输出
参数类型描述
incident_roleobject创建的事件角色

查看事件角色

操作
查看事件角色
API 密钥*
••••••••
ID*
输入 ID...
显示事件角色 (incidentio_incident_roles_show)

获取 incident.io 中特定事件角色的详细信息

输入
参数类型必填描述
apiKey字符串是incident.io API 密钥
id字符串是事件角色的 ID
输出
参数类型描述
incident_role对象事件角色的详细信息

更新事件角色

操作
更新事件角色
API 密钥*
••••••••
ID*
输入 ID...
名称*
输入名称...
描述*
输入描述...
说明*
输入角色的说明...
缩写*
输入缩写形式(例如:INC, LEAD)...
更新事件角色(incidentio_incident_roles_update)

在 incident.io 中更新现有事件角色

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
idstring是要更新的事件角色 ID
namestring是事件角色名称
descriptionstring是事件角色说明
instructionsstring是事件角色的处理指引
shortformstring是该角色的简称
输出
参数类型说明
incident_roleobject更新后的事件角色

删除事件角色

操作
删除事件角色
API 密钥*
••••••••
ID*
输入 ID...
删除事件角色(incidentio_incident_roles_delete)

在 incident.io 中删除事件角色

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
idstring是要删除的事件角色 ID
输出
参数类型说明
messagestring成功消息

列出事件时间戳

操作
列出事件时间戳
API 密钥*
••••••••
列出事件时间戳 (incidentio_incident_timestamps_list)

列出 incident.io 中的所有事件时间戳定义

输入
参数类型必需描述
apiKeystring是incident.io API 密钥
输出
参数类型描述
incident_timestamps数组事件时间戳定义列表

显示事件时间戳

操作
显示事件时间戳
API 密钥*
••••••••
ID*
输入 ID...
显示事件时间戳(incidentio_incident_timestamps_show)

获取 incident.io 中特定事件时间戳定义的详细信息

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
idstring是事件时间戳的 ID
输出
参数类型描述
incident_timestampobject事件时间戳详情

列出事件更新

操作
列出事件更新
API 密钥*
••••••••
每页数量
25
之后(分页)
用于分页的游标
事件 ID
输入事件 ID(可选 - 留空以包含所有事件)...
列出事件更新 (incidentio_incident_updates_list)

列出 incident.io 中特定事件的所有更新

输入
参数类型必需描述
apiKeystring是incident.io API 密钥
incident_idstring否要获取更新的事件 ID (可选 - 如果未提供,则返回所有更新)
page_sizenumber否每页返回的结果数
afterstring否分页游标
输出
参数类型描述
incident_updatesarray事件更新列表
pagination_metaobject分页信息

列出排班条目

操作
列出排班条目
API 密钥*
••••••••
每页大小
25
之后(分页)
分页游标
排班 ID*
输入排班 ID...
条目窗口开始时间(日期/时间)
例如:2024-01-01 00:00:00...
条目窗口结束时间(日期/时间)
2024-12-31 23:59:59...
列出排班条目 (incidentio_schedule_entries_list)

列出 incident.io 中指定排班的所有条目

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
schedule_idstring是要获取条目的排班 ID
entry_window_startstring否筛选条目的开始日期/时间(ISO 8601 格式)
entry_window_endstring否筛选条目的结束日期/时间(ISO 8601 格式)
page_sizenumber否每页返回的结果数
afterstring否分页游标
输出
参数类型描述
schedule_entriesarray排班条目列表
pagination_metaobject分页信息

创建排班覆盖

操作
创建排班覆盖
API 密钥*
••••••••
排班 ID*
输入排班 ID...
轮值 ID*
输入轮值 ID...
用户 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 中创建新的排班覆盖

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
rotation_idstring是要覆盖的轮值 ID
schedule_idstring是排班 ID
user_idstring否要分配的用户的 ID(请提供以下之一:user_id、user_email 或 user_slack_id)
user_emailstring否要分配的用户的邮箱(请提供以下之一:user_id、user_email 或 user_slack_id)
user_slack_idstring否要分配的用户的 Slack ID(请提供以下之一:user_id、user_email 或 user_slack_id)
start_atstring是覆盖开始时间(ISO 8601 格式)
end_atstring是覆盖结束时间(ISO 8601 格式)
输出
参数类型说明
overrideobject创建的排班覆盖

创建升级路径

操作
创建升级路径
API 密钥*
••••••••
名称*
输入名称...
路径配置*
升级层级的 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 中创建新的升级路径

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
namestring是升级路径的名称
pathjson是包含目标和确认时间(秒)的升级级别数组。每个级别应包含:targets (由 {id, type, schedule_id?, user_id?, urgency} 组成的数组) 和 time_to_ack_seconds (数字)
working_hoursjson否可选的工作时间配置。由 {weekday, start_time, end_time} 组成的数组
输出
参数类型描述
escalation_pathobject创建的升级路径

显示升级路径

操作
显示升级路径
API 密钥*
••••••••
ID*
输入 ID...
查看升级路径 (incidentio_escalation_paths_show)

获取 incident.io 中特定升级路径的详情

输入
参数类型必填说明
apiKeystring是incident.io API 密钥
idstring是升级路径的 ID
输出
参数类型说明
escalation_pathobject升级路径详情

更新升级路径

操作
更新升级路径
API 密钥*
••••••••
ID*
输入 ID...
名称
输入名称(更新时可选)...
路径配置
升级级别的 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 中的现有升级路径

输入
参数类型必填描述
apiKeystringYesincident.io API 密钥
idstringYes要更新的升级路径 ID
namestringNo升级路径的新名称
pathjsonNo新的升级路径配置。包含目标和 time_to_ack_seconds 的升级级别数组
working_hoursjsonNo新的工作时间配置。{weekday, start_time, end_time} 数组
输出
参数类型描述
escalation_pathobject更新后的升级路径

删除升级路径

操作
删除升级路径
API 密钥*
••••••••
ID*
输入 ID...
删除升级路径 (incidentio_escalation_paths_delete)

在 incident.io 中删除升级路径

输入
参数类型必填描述
apiKeystring是incident.io API 密钥
idstring是要删除的升级路径的 ID
输出
参数类型描述
messagestring成功消息

使用说明

将 incident.io 集成到工作流中。管理事件、行动、跟进、工作流、时间表、升级、自定义字段等。

备注

  • 类别: tools
  • 类型: incidentio