# Hyrule Cloud DNS Propagation Check

> Hyrule Cloud DNS Propagation Check is a paid API for AI agents from cloud.hyrule.host, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Checks whether a DNS record has propagated across multiple resolvers globally, comparing actual values against expected ones and reporting discrepancies

## Facts

- Endpoint: POST https://cloud.hyrule.host/v1/dns/propagation
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyrule-cloud-dns-propagation-check-577b3030
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eYKOeVM38kNPQZQrRzIZS

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hyrule-cloud-dns-propagation-check-577b3030 -d '<json body>'
```

Example prompt: Check whether the A record for api.example.com has propagated to the value 203.0.113.5 across authoritative resolvers, with a 5000ms timeout.

## When to prefer this

Use this endpoint when you need to programmatically verify that DNS changes (record updates, nameserver migrations, new zone entries) have propagated across the internet, especially when you need to compare actual resolver responses against expected values. Prefer this over a simple DNS lookup when you need multi-resolver comparison, propagation status across the DNS network, or structured diagnostic findings with severity levels rather than raw record data.

## Known failure modes

- Domain name not found or invalid — returns error status
- Timeout exceeded if resolvers are slow and timeout_ms is set too low
- Expected values don't match any resolver responses — returns warning or critical findings
- Resolver list contains unreachable or invalid resolver addresses
- Record type not supported or mismatch with actual record — returns mismatch finding

## How this service works

Full-stack network infrastructure for AI agents on AS215932 (RIPE): IPv6-native VMs with SSH and automatic HTTPS subdomains, domain registration and DNS, a broad network-intelligence suite (BGP/routing, IP/ASN & reputation, DNS, RDAP/WHOIS, web & deep TLS, mail deliverability, port/NAT/CGNAT, VoIP/SIP), and proxied requests over Direct/Tor/I2P/Yggdrasil. Pay per request in USDC on Base via x402; VM checkout may also accept BTC/XMR when advertised. This OpenAPI document intentionally contains only the launch-ready, independently payable agent surface.

## Output

Returns a diagnostic response including an overall status (ok/info/warning/critical/error), a human-readable summary, a list of findings with severity codes and messages, per-resolver results showing what each returned, whether results are partial, the normalized target domain, and a unique request_id with a timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "title": "Name",
   "maxLength": 253,
   "minLength": 1
  },
  "type": {
   "enum": [
    "A",
    "AAAA",
    "CAA",
    "CNAME",
    "DNSKEY",
    "DS",
    "MX",
    "NAPTR",
    "NS",
    "PTR",
    "SOA",
    "SRV",
    "TXT",
    "TLSA",
    "ANY"
   ],
   "type": "string",
   "title": "DNSLookupRecordType",
   "default": "A"
  },
  "expected": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Expected"
  },
  "resolvers": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "title": "Resolvers"
  },
  "timeout_ms": {
   "type": "integer",
   "title": "Timeout Ms",
   "default": 3000,
   "maximum": 30000,
   "minimum": 500
  },
  "authoritative": {
   "type": "boolean",
   "title": "Authoritative",
   "default": true
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "ok",
  "target": {
   "type": "domain",
   "input": "example.com",
   "normalized": "example.com"
  },
  "partial": false,
  "sources": {},
  "summary": "DNS propagation compared",
  "findings": [
   {
    "code": "example",
    "message": "No issue found",
    "severity": "ok"
   }
  ],
  "request_id": "diag_a1b2c3d4",
  "generated_at": "2026-07-15T00:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyrule-cloud-dns-propagation-check-577b3030/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cloud.hyrule.host](https://www.zero.xyz/host/cloud.hyrule.host/llms.txt)