更新回调规则¶

接口用途¶

更新回调规则，例如启停规则或调整 target。

请求方式¶

PATCH

接口地址¶

https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/callback-rules/<callback_rule_id>

身份认证¶

使用工作区 API Key，在请求头中携带 X-API-Key: <WORKSPACE_API_KEY>，并设置 Content-Type: application/json。

路径参数¶

名称	说明
`callback_rule_id`	回调规则标识。

查询参数¶

无。

请求体¶

部分更新；version 必填用于乐观并发。

字段	类型	必填	说明
`version`	integer	是	当前版本号
`name`	string	否	名称
`description`	string	否	描述
`enabled`	boolean	否	启停
`priority`	integer	否	优先级
`match`	object	否	匹配条件
`target_type`	string	否	目标类型
`target_config`	object	否	目标配置
`stop_after_match`	boolean	否	匹配后停止

请求示例¶

curl -X PATCH 'https://moi.matrixorigin.cn/newmoi/workspaces/<workspace_id>/callback-rules/<callback_rule_id>' \
  -H 'X-API-Key: <WORKSPACE_API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"version":1,"enabled":false}'

响应说明¶

除 A2A JSON-RPC 外，多数工作区接口成功响应形如 {"code":0,"data":...}；下列字段描述 data（或 HTTP 202 时的 data）。

返回更新后的规则：

字段	类型	说明
`id`	string	规则 ID
`workspace_id`	string	工作区 ID
`provider`	string	事件提供方，如 `feishu`
`credential_ref`	string	与回调入口对应的凭据引用
`name`	string	规则名称
`description`	string	描述
`enabled`	boolean	是否启用
`priority`	integer	优先级
`match`	object	可含 `event_types` / `event_actions` / `field_equals`
`target_type`	string	转发目标类型（如自动化任务）
`target_config`	object	目标配置
`stop_after_match`	boolean	匹配后是否停止后续规则
`version`	integer	版本（更新时必填）
`created_at`	string	创建时间
`updated_at`	string	更新时间

使用限制¶

更新目标配置后需重新确认入站映射是否符合预期。