sangtao.ai
API key

Webhook

Sửa endpoint

Đổi URL, sự kiện, ghi chú của endpoint, hoặc tắt / bật nó.

PATCHhttps://api.sangtao.ai/v2/webhooks/{id}

Xác thực

  • X-Api-Keystring · headerbắt buộc

    API key của bạn, tạo ở trang API key trong tài khoản.

Tham số đường dẫn

  • idstringbắt buộc

    ID trong đường dẫn.

Body

  • urlstring

    URL mới, kiểm như lúc tạo

  • eventsstring[]

    Thay cả danh sách

    Giá trị có thể:*image.completedimage.failedvideo.completedvideo.failedpost.publishedpost.failedsocial_account.needs_attention

  • descriptionstring

    Tối đa 200 ký tự

  • enabledboolean

    false để ngừng gửi. true để bật lại, kể cả khi đang disabled_failing

Chỉ gửi trường cần đổi. Response là cả endpoint.

Mã lỗi

MãerrorCodeKhi nào
404WEBHOOK_NOT_FOUNDKhông có endpoint nào của bạn với id này
422INVALID_WEBHOOK_URLurl không phải URL https công khai cổng 443, hoặc có kèm tài khoản / mật khẩu
422INVALID_WEBHOOK_EVENTevents trống hoặc có loại không tồn tại — các loại hợp lệ ở details[0].params.allowed
422VALIDATION_ERRORdescription dài quá 200 ký tự
PATCH/webhooks/{id}
curl -X PATCH "https://api.sangtao.ai/v2/webhooks/whk_4nP8rT2xK" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      "*"
    ]
  }'
{
  "success": true,
  "data": {
    "id": "whk_4nP8rT2xK",
    "url": "https://example.com/webhooks/sangtao",
    "events": [
      "*"
    ],
    "description": "Production",
    "enabled": true,
    "status": "active",
    "createdAt": "2026-11-10T08:00:00Z",
    "lastDeliveryAt": "2026-11-10T09:43:32Z",
    "lastSuccessAt": "2026-11-10T09:43:32Z",
    "lastFailureAt": null
  }
}