v1

latestOpenAPI 3.1.02026-07-2665164286.3 KB

Webhooks

Update Webhook Endpoint

Updates the URL and/or subscribed event types for a webhook endpoint. The events array is fully replaced — include all types you want to keep.

patch/v3/webhooks/endpoints/{endpoint_id}

Path parameters

endpoint_idstring required

Webhook endpoint ID

Request body

urlstring nullable

New URL for the endpoint. Must be publicly accessible HTTPS.

eventsWebhookEventType[] nullable

New list of event types to subscribe to. Replaces the existing list.

Response

Successful response

Example response

{
  "data": {
    "endpoint_id": "ep_abc123def456",
    "url": "https://example.com/webhook",
    "events": [
      "avatar_video.success",
      "avatar_video.fail"
    ],
    "status": "enabled",
    "created_at": "2024-04-01T12:00:00Z",
    "secret": "whsec_abc123def456"
  }
}