Sign in

v1

latestOpenAPI 3.0.1MIT2026-07-2638658.5 KB
Webhook

Update Webhook Endpoint

Update an existing webhook endpoint configuration including URL, status, and subscribed events.

put/v2/endpoint/{endpoint_id}

Path parameters

endpoint_idstring required
Example:wh_123456

Unique webhook endpoint identifier

Request body

urlstring uri required

Updated webhook endpoint URL

status'enabled' | 'disabled' required

Webhook status

eventsstring[] required

Updated list of event types

Example request

{
  "url": "https://your-domain.com/webhook",
  "status": "enabled",
  "events": [
    "generated_avatar_video_success",
    "generated_avatar_video_failed",
    "generated_photo_avatar_success"
  ]
}

Response

Success

codeinteger required

Business status code:

  • 0 - Success
  • 10104 - Record not found
  • 10105 - Invalid API key
  • 18020 - Insufficient credit
  • 18025 - No permission to call APIs
  • 40000 - Parameter error
  • 50000 - System error
msgstring required

Response message

Example response

{
  "msg": "Success",
  "data": {
    "endpoint_id": "wh_123456789",
    "url": "https://your-domain.com/webhook",
    "secret": "whsec_abc123xyz",
    "status": "enabled",
    "events": [
      "generated_avatar_video_success",
      "generated_avatar_video_failed"
    ],
    "username": "johndoe",
    "created_at": 1732806631
  }
}