POST https://ark.cn-beijing.volces.com/api/v3/webhook_endpoints
创建 Webhook 接入点，订阅当前账号和项目中的 Managed Agents 业务事件。创建成功返回 200，接入点默认启用。
同一地域、账号和项目内最多创建 20 个接入点，启用和停用状态均计入配额。同一项目内回调 URL 必须唯一。
鉴权#
本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。
- API Key 鉴权，请在 API Key 管理 页面，获取长效 API Key。
请求参数#
Body 参数#
events string[] 必选 | 订阅事件
订阅的业务事件类型列表。至少填写一个事件，不支持通配符或资源 ID 过滤。可选值：session.status_run_started、session.status_idled、session.status_terminated、span.outcome_evaluation_end、session.error、session.thread_status_running、session.thread_status_idle、session.thread_status_terminated、session.updated、session.deleted、agent.created、agent.updated、agent.deleted、environment.created、environment.updated、environment.deleted、memory_store.created、memory_store.deleted、vault.created、vault.deleted、vault_credential.created、vault_credential.deleted、vault_credential.refresh_failed。
url string 必选 | 回调地址
接收 Webhook 请求的公网 HTTP 或 HTTPS 地址。平台不跟随重定向。
description string / null | 接入点描述
Webhook 接入点的用途说明，最长 256 个字符。省略、传 null 或空字符串时保存为 null。
响应参数#
consecutive_failures integer | 连续失败数
连续最终投递失败的业务事件数量。业务事件成功投递或重新启用接入点时清零；单个事件的多次尝试只计一次。
最小值：0
created_at string | 创建时间
Webhook 接入点的创建时间，采用 RFC 3339 格式。
description string / null | 接入点描述
Webhook 接入点的用途说明。未设置时返回 null。
disabled_reason string / null | 停用原因
Webhook 接入点当前的停用原因。接入点处于 ACTIVE 状态时返回 null。
events string[] | 订阅事件
该接入点订阅的业务事件类型列表。平台仅向该接入点投递列表中的事件。可选值：session.status_run_started、session.status_idled、session.status_terminated、span.outcome_evaluation_end、session.error、session.thread_status_running、session.thread_status_idle、session.thread_status_terminated、session.updated、session.deleted、agent.created、agent.updated、agent.deleted、environment.created、environment.updated、environment.deleted、memory_store.created、memory_store.deleted、vault.created、vault.deleted、vault_credential.created、vault_credential.deleted、vault_credential.refresh_failed。
id string | 接入点 ID
Webhook 接入点 ID，以 wep- 开头。后续管理操作通过该 ID 定位接入点。
last_error_code string / null | 最近失败分类
最近一次业务事件最终投递失败的错误分类。尚无最终失败时返回 null；测试事件不更新该字段。
last_failure_at string / null | 最近失败时间
最近一次业务事件最终投递失败的时间。尚无最终失败时返回 null；测试事件不更新该字段。
last_http_status integer / null | 最近失败状态码
最近一次业务事件最终投递失败时收到的 HTTP 状态码。因网络错误未收到响应或尚无最终失败时返回 null；测试事件不更新该字段。
取值范围：[100, 599]
last_success_at string / null | 最近成功时间
最近一次业务事件成功投递的时间。尚无成功投递时返回 null；测试事件不更新该字段。
signing_secret string | 签名密钥
用于验证 Webhook 请求签名的密钥，以 whsec_ 开头。该字段仅在创建成功响应中返回一次，列表和详情接口无法再次获取。
status string | 接入点状态
Webhook 接入点的启用状态。ACTIVE 表示接收业务事件；DISABLED 表示暂停业务事件投递。
updated_at string | 更新时间
Webhook 接入点配置、签名密钥或启停状态最后一次变化的时间，采用 RFC 3339 格式。业务投递统计变化不会更新该字段；自动停用会更新该字段。
url string | 回调地址
平台发送 Webhook 请求的公网 HTTP 或 HTTPS 地址。平台不跟随重定向。