Webhook management

Update a webhook

Update the URL and/or status. A webhook cannot be set active directly – it must pass a test (TEST_REQUIRED). Changing the URL drops the webhook back to disabled and requires a fresh test.

patch/v1/webhooks/{id}

Request

  • Base URL: https://api.vatnode.dev
  • URL: https://api.vatnode.dev/v1/webhooks/{id}
  • Auth: one of:
    • API key in cookie better-auth.session_token
    • HTTP bearer

Path parameters

idstring required

Webhook identifier.

Request body

urlstring uri

New publicly reachable HTTPS endpoint.

status'disabled'

Only disabled is accepted; activation happens via a test.

Response

The updated webhook.

idstring required
urlstring uri required
status'active' | 'disabled' | 'inactive' required
consecutiveFailuresinteger

Consecutive failed deliveries. Present on list/update responses.

createdAtstring date-time required
updatedAtstring date-time required

Changes

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