PUT/v3/webhooks/{webhook-id}Update a v3 webhook

Update a v3 webhook's url, secret and subscribed event types in place, keeping the same HMAC secret.

header	Authorization	Authentication token (bearer token or API key).
{ "secretHttp" : String, "webhookUrl" : String, "types" : ["DeviceActivation" / "DeviceDeactivation" / "DeviceBoot" / "DeviceStatus" / "DeviceTamperVibration" / "DeviceTamperRotations" / "DeviceTamperFaultyPin" / "DeviceLocked" / "MatterCommissioning" / "ThreadConnection"] }

Response

status	401	Invalid authentication token
{}

Example: Update a v3 webhook

PUT/v3/webhooks/2

header	Authorization	Bearer c94e0909-7100-43c1-b822-15d8761f7f20
{ "webhookUrl": "https://webhook.example.com/v3-updated", "types": ["DeviceLocked", "ThreadConnection"] }

Response

status	200
header	Access-Control-Expose-Headers	authorization, content-type
header	Access-Control-Allow-Headers	authorization, content-type
header	Access-Control-Allow-Methods	GET, POST, DELETE, OPTIONS, PUT
header	Access-Control-Allow-Origin	*
header	Strict-Transport-Security	max-age=31536000; includeSubDomains
header	X-Frame-Options	SAMEORIGIN
header	X-Content-Type-Options	nosniff
header	X-XSS-Protection	1; mode=block
header	Content-Security-Policy	default-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
header	Referrer-Policy	no-referrer
header	Feature-Policy	self
header	Permissions-policy	interest-cohort=()
{}

Example: Reject updating a non-v3 webhook

Example: Reject updating a v3 webhook to a URL already used by another webhook