Webhook

禁用 Webhook

手动禁用 Webhook

POST

/api/v1/agentstudio/webhook_endpoints/{id}/disable

cURL

curl --request POST \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/webhook_endpoints/{id}/disable' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "id": "wep_01JXX7YQGPRPV1BZXA35QE7WDP",
  "description": "生产环境会话事件",
  "url": "https://example.com/managedagent/webhooks",
  "events": [
    "session.status_idled"
  ],
  "status": "DISABLED",
  "disabled_reason": "MANUAL",
  "consecutive_fail": 2,
  "last_success_at": "2026-08-06T10:05:00Z",
  "last_failure_at": "2026-08-06T10:10:00Z",
  "created_at": "2026-08-06T10:00:00Z",
  "updated_at": "2026-08-06T10:25:00Z",
  "request_id": "8e1d16e4"
}

鉴权

string

header

必填

DashScope API Key

路径参数

string

必填

Webhook ID，格式 wep_<ULID>

响应

200-application/json

string

string | null

string

string[]

enum<string>

禁用后为 DISABLED

可选值：ACTIVE,DISABLED

string | null

手动禁用为 MANUAL

integer

返回禁用完成时的当前值

string | null

返回禁用完成时的当前值

string | null

返回禁用完成时的当前值

string

cURL

curl --request POST \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/webhook_endpoints/{id}/disable' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "id": "wep_01JXX7YQGPRPV1BZXA35QE7WDP",
  "description": "生产环境会话事件",
  "url": "https://example.com/managedagent/webhooks",
  "events": [
    "session.status_idled"
  ],
  "status": "DISABLED",
  "disabled_reason": "MANUAL",
  "consecutive_fail": 2,
  "last_success_at": "2026-08-06T10:05:00Z",
  "last_failure_at": "2026-08-06T10:10:00Z",
  "created_at": "2026-08-06T10:00:00Z",
  "updated_at": "2026-08-06T10:25:00Z",
  "request_id": "8e1d16e4"
}