PUT /webhooks/{webhook_id}

Replace a webhook's configuration.

MethodPath
PUT/v1/webhooks/{webhook_id}

Changing the URL cancels outstanding deliveries, clears verification and approval, and sends another ping. State and signing secret cannot be set here. Updating description or subscriptions preserves approval.

Path parameters

webhook_idstringrequired
curl -X PUT "https://api.ellipsis.dev/v1/webhooks/{webhook_id}" \
  -H "Authorization: Bearer $ELLIPSIS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "events": [
    "session.create"
  ],
  "url": "https://example.com/hooks"
}'

Request

Example request body
{
"url": "https://example.com/hooks"
}

Body parameters

descriptionstring
eventsarray<string>required

Explicit event subscriptions. Currently only session.create is supported. Pings are sent independently of subscriptions.

urlstringrequired

The single public HTTPS URL to receive signed POST requests. Changing it requires verification and approval again.

Response

Example response · 200
{
}

On this page

No Headings
Schedule a demo