Update Subscription - Webhooks API
Update Subscription - Changes the callback URL, chains or filters of a subscription
Update Subscription - [Value: 20CU]
Updates callback_url, chain_ids or filters (at least one) and returns the updated Subscription object. Fields you leave out don't change
PATCH https://lb.drpc.live/lambda/{key}/v1/webhooks/subscriptions/{id}
Use cases
- Move deliveries to a new callback URL
- Narrow or widen the list of chains
- Turn spam deliveries on or off
Constraints
- At least one field is required, otherwise 422
- Staking filter can't be added or removed after create (422)
- The same validation rules as on create apply
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key
Language
Request
Examples
curl --request PATCH \
--url https://lb.drpc.live/lambda/{key}/v1/webhooks/subscriptions/0450d9f4-304f-420f-9b49-3625d9c52c1f \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"callback_url": "https://example.com/hooks/v2",
"chain_ids": [
"ethereum"
]
}'Response
200
{
"id": "0450d9f4-304f-420f-9b49-3625d9c52c1f",
"callback_url": "https://example.com/hooks/v2",
"status": "enabled",
"chain_ids": [
"ethereum"
],
"filters": {},
"address_count": 1,
"created_at": "2026-09-21T12:52:46.024339Z",
"updated_at": "2026-09-22T09:14:03.512871Z"
}Path params
keystring
[Required] Your dRPC API key
idstring
[Required] Subscription id (UUID) returned on create
Query params
Request params
object
callback_urlstring
HTTPS URL on a public host. Private and reserved IPs, localhost and internal suffixes are rejected
chain_idsarray_of_strings
Up to 50 chain slugs. [] for all chains
filtersobject
Replaces the stored filters as a whole, so send every key you want to keep. On a staking subscription keep event_kinds: ["staking"] in it
Response
200
Response params
object
idstring
[Required] Subscription id (UUID)
callback_urlstring
[Required] HTTPS URL that receives signed POST deliveries
statusstring
[Required] Only enabled subscriptions get deliveries
chain_idsarray_of_strings
[Required] Lowercase chain slugs. [] means every supported chain, including future ones
filtersobject
[Required] Subscription filters. {} when none are set
address_countinteger
[Required] How many addresses the subscription watches. The list itself is never inlined; use List Addresses
created_atstring
[Required] Creation time, ISO 8601
updated_atstring
[Required] Last update time, ISO 8601