{"uid":"cap_5mRnTD3HsxmyPSAsnNiiA","slug":"dns-doctor-dns-record-watch-b8c769f8","name":"DNS Doctor — DNS Record Watch","description":"Scan, fix and verify your domain's DNS: SPF, DMARC and DKIM, global propagation, DNS health and expiry. Deterministic copy-paste fixes, never an AI guess.","url":"https://dnsdoctor.dev/api/v1/watch/record?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"host":{"type":"string"},"kind":{"enum":["spf","dmarc","txt","mx","cname","a","aaaa"],"type":"string"},"domain":{"type":"string"},"window_hours":{"type":"number","maximum":24,"minimum":1}}},"responseSchema":{"type":"json","example":{"state":"running","poll_url":"https://dnsdoctor.dev/api/v1/watch/wid_example","watch_id":"wid_example","expires_at":"2026-09-06T12:00:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004167","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004167/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004167","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004167","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ZJ8gz3r4sIDuvQNNZtrsA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004167","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Starts a paid watch job that continuously monitors a specific DNS record type for a domain over a configurable time window, returning a poll URL to retrieve results.","exampleAgentPrompt":"Watch my SPF record on example.com for the next 4 hours and let me know when it changes — I just updated it and want to confirm it propagates correctly.","exampleUseCases":[{"title":"Post-migration DNS propagation check","prompt":"I just moved example.com to a new DNS provider and updated the MX records. Can you watch the MX record for example.com for 6 hours and alert me when the new records have propagated?"},{"title":"Email deliverability DMARC rollout","prompt":"I just published a DMARC policy for mycompany.com. Watch the DMARC record for the next 3 hours so I can confirm it's live before I announce the change to the team."},{"title":"CNAME cutover verification","prompt":"We're pointing blog.acmecorp.com via a new CNAME as part of a site migration. Please watch that CNAME record for 2 hours and tell me as soon as it resolves to the new target."}],"resultDescription":"Returns a JSON object containing a unique watch_id, a poll_url to check the status of the watch job, the initial state ('running'), and an expires_at timestamp indicating when the watch window ends. The agent must poll the returned poll_url to retrieve actual propagation results.","failureModes":["Invalid record type enum value — must be one of: spf, dmarc, txt, mx, cname, a, aaaa","window_hours out of range — must be between 1 and 24","Missing required domain field — returns validation error","Payment failure via x402 protocol — watch job not created","Invalid domain format — malformed hostname rejected","Network timeout before job is queued — no watch_id returned"],"whenToPreferThis":"Use this endpoint when you need to continuously monitor a specific DNS record over a defined time window (up to 24 hours) rather than doing a one-off snapshot lookup. It is ideal for post-change propagation verification (e.g. after updating SPF, DMARC, MX, or CNAME records) where you want asynchronous polling rather than an immediate result. Prefer the bulk scan endpoint for auditing many domains at once, and prefer the propagation watch endpoint if you want multi-vantage-point geographic checks rather than record-type-specific monitoring.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:35:15.672Z","isFirstParty":false,"canonicalSlug":"dns-doctor-dns-record-watch-b8c769f8"}