Skip to main content
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}

​
Path parameters

​
id
string
required
The webhook endpoint id to update.

​
Body

Send any subset of the following. Omitted fields are left unchanged.
​
url
string
New HTTPS endpoint to deliver events to.
​
enabled
boolean
false pauses deliveries; true resumes them.
​
eventTypes
string[]
Replace the subscribed event list. See the full set on create.
The secret survives. Updating an endpoint keeps its signingSecret. To rotate the secret, delete the endpoint and create a new one.

​
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 }'

​
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": ""
}