Skip to content

Delete a DNS record

DELETE
/dns/{domain}/{recordId}

Deletes a DNS record from a domain owned by the authenticated wallet. Requires x402 payment of $0.10 USDC. Rate limited: 100 requests per hour per wallet.

domain
required
string

Fully qualified domain name (e.g. “example.com”)

recordId
required
string

DNS record ID

DNS record deleted

object
message
required
string
Allowed value: DNS record deleted

Authentication required

object
error
required

Short error description

string
message
required

Human-readable error message

string
code
required

Machine-readable error code

string

Payment required

object
error
required

Short error description

string
message
required

Human-readable error message

string
code
required

Machine-readable error code

string
PAYMENT-REQUIRED
string

X402 payment requirements encoded as a JSON object

Ownership denied

object
error
required

Short error description

string
message
required

Human-readable error message

string
code
required

Machine-readable error code

string

Record not found

object
error
required

Short error description

string
message
required

Human-readable error message

string
code
required

Machine-readable error code

string

Rate limit exceeded

object
error
required

Short error description

string
message
required

Human-readable error message

string
code
required

Machine-readable error code

string