Docs
DashboardGet API key
API · webhooks

Update a webhook

A partial update. Pause or resume an endpoint, change where it points, or change which events it receives — all without rotating the signing secret.

PATCH/v1/webhooks/{id}

01 Path parameters

idstringRequired
The webhook endpoint id to update.

02 Body

Send any subset of the following. Omitted fields are left unchanged.

urlstringOptional
New HTTPS endpoint to deliver events to.
enabledbooleanOptional
false pauses deliveries; true resumes them.
eventTypesstring[]Optional
Replace the subscribed event list. See the full set on create.
The secret survivesUpdating an endpoint keeps its signingSecret. To rotate the secret, delete the endpoint and create a new one.

03 Request

curl -X PATCH https://api.drin.run/v1/webhooks/wh_3kQ9p2 \
  -H "Authorization: Bearer $DRIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": false }'

04 Response

Returns 200 OK with the updated endpoint (secret redacted). An unknown id returns 404 not_found.

200 OK
{
  "id": "wh_3kQ9p2",
  "url": "https://example.com/hooks/drin",
  "enabled": false,
  "eventTypes": ["delivery", "bounce", "complaint"],
  "signingSecret": ""
}