Disable Webhook

更新时间: 2026-11-16 22:11:32

Manually disables a Webhook. The request body is empty. After disabling, no new events are delivered. Events already produced but not yet delivered are cancelled.

Prerequisites

Endpoint and authentication configured. For details, see API overview and authentication.

Endpoint

POST /webhook_endpoints/{id}/disable

Path parameters

id string (必选)

Webhook ID, format wep_<ULID>

Request example

curl -X POST "$AGENTSTUDIO_URL/webhook_endpoints/wep_01JXX7YQGPRPV1BZXA35QE7WDP/disable" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

Response fields

id string

—

description string | null

—

url string

—

events array<string>

—

status string

DISABLED after being disabled

disabled_reason string | null

MANUAL for manual disable

consecutive_fail integer

Current value at the time of disable

last_success_at string | null

Current value at the time of disable

last_failure_at string | null

Current value at the time of disable

created_at string

—

updated_at string

—

request_id string

Unique identifier of this request; attach it when troubleshooting

Response

{
  "id": "wep_01JXX7YQGPRPV1BZXA35QE7WDP",
  "description": "Production session events",
  "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"
}

Error codes

HTTP statusError codeDescription
40411800001webhook not found
上一篇: Enable Webhook 下一篇: Test Webhook
阿里云首页 大模型服务平台百炼 相关技术圈