watch

Create Propagation Watch

Buy a propagation watch: one name, six vantage points, up to 24 hours.

Anonymous; 402 on every call. Gate order is the contract — inert 503, then the 422 on a malformed target, then the fleet-wide caps' 429, and only then the lane. Everything that can refuse refuses before any money moves, and the payment is settled only once the row is committed.

post/watch/propagation

Request

  • Base URL: https://dnsdoctor.dev/api/v1
  • URL: https://dnsdoctor.dev/api/v1/watch/propagation
  • Auth: none declared

Request body

namestring required
record_typestring
expected_valuestring nullable

The value every vantage point must agree on for the watch to report met. Without it, met means the grid agreed on an answer set DIFFERENT from the first one recorded — a name whose answers legitimately rotate (an ELB/ALB or GSLB hostname) meets on the rotation, not on your change; pass the value you are waiting for.

window_hoursnumber

Response

Successful Response

watch_idstring required
kindstring required
targetstring required
record_typestring nullable required
expected_valuestring nullable required
statestring required
cadence_secondsinteger required
window_hoursnumber required
price_usdstring required
created_atstring required
expires_atstring required
results_expire_atstring required
poll_urlstring required

Changes

No recorded changes to this operation across all 2 revisions of this API.