Monitors
Rotate a monitor webhook signing secret
Replaces the signing secret for an owned monitor that has notifyWebhookUrl configured. The response is the only disclosure of the replacement: monitor reads and lists never include it. Store it on receipt.
Every accepted call creates a new secret; this operation is not idempotent. Deliveries already queued retain the secret snapshotted when they were accepted, so a receiver should accept both the previous and replacement secrets until those attempts drain.
A missing, foreign, or notification-less monitor answers the same 404 MONITOR_NOT_FOUND. Never billed and never launches a browser.
post/monitors/{monitorId}/rotate-secret
Request
- Base URL: https://api.domscout.io
- URL: https://api.domscout.io/monitors/{monitorId}/rotate-secret
- Auth: API key in header x-api-key
Path parameters
monitorIdstring uuid required
Response
Rotated. The replacement secret is shown only in this response.
Changes
No recorded changes to this operation across all 1 revision of this API.