Update webhook configuration

Updates URL, description, and/or event type subscriptions. Only provided fields are changed; event_types replaces the full allowlist.

x-api-keystring

RootPay API key sent in the x-api-key header. Keys are environment-scoped: live_* for production, test_* for sandbox.

webhook_idstringRequiredformat: "uuid"

This endpoint expects an object.

urlstring or nullOptionalformat: "uri"1-2083 characters

descriptionstring or nullOptional

event_typeslist of enums or nullOptional

Replace the full subscription allowlist when provided.

Webhook configuration updated successfully

dataobject

warningstring or null

$	curl -X PATCH https://api.useroot.com/api/webhooks/webhook_id \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"description": "Production payouts only",
>	"event_types": [
>	"payout.settled",
>	"payout.failed"
>	]
>	}'

1	{
2	"data": {
3	"created_at": "2024-03-20T12:00:00Z",
4	"updated_at": "2024-03-20T12:00:00Z",
5	"id": "123e4567-e89b-12d3-a456-426614174000",
6	"url": "https://example.com/webhook",
7	"description": "Production payouts only",
8	"is_active": true,
9	"event_types": [
10	"payout.failed",
11	"payout.settled"
12	]
13	}
14	}