v1

Update Webhook

Replace a webhook's configuration.

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.

put/v1/webhooks/{id}

Request

  • Base URL
    https://api.ellipsis.dev
  • URL
    https://api.ellipsis.dev/v1/webhooks/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

Headers

user-agentstring nullable

Request body

descriptionstring nullable
eventsstring[] required

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

urlstring required

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

Example request

{
  "events": [
    "session.create"
  ],
  "url": "https://example.com/hooks"
}

Response

Successful Response

Changes

No recorded changes to this operation across all 1 revision of this API.