Update a DNS record

PUT

/dns/{domain}/{recordId}

• Production

Updates an existing DNS record on a domain owned by the authenticated wallet. At least one field (host, value, ttl, or priority) must be provided. Requires x402 payment of $0.10 USDC. Rate limited: 100 requests per hour per wallet.

Authorizations

• bearerAuth

Parameters

Path Parameters

domain

required

string

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

recordId

required

string

DNS record ID

Request Body ^required

Any of:

object

At least one of host, value, ttl, or priority must be provided.

object

host

required

New hostname for the record

string

value

New value for the record

string

ttl

New TTL in seconds

integer

>= 300 <= 86400

priority

New priority for MX/SRV records

integer

<= 65535

object

At least one of host, value, ttl, or priority must be provided.

object

host

New hostname for the record

string

value

required

New value for the record

string

ttl

New TTL in seconds

integer

>= 300 <= 86400

priority

New priority for MX/SRV records

integer

<= 65535

object

At least one of host, value, ttl, or priority must be provided.

object

host

New hostname for the record

string

value

New value for the record

string

ttl

required

New TTL in seconds

integer

>= 300 <= 86400

priority

New priority for MX/SRV records

integer

<= 65535

object

At least one of host, value, ttl, or priority must be provided.

object

host

New hostname for the record

string

value

New value for the record

string

ttl

New TTL in seconds

integer

>= 300 <= 86400

priority

required

New priority for MX/SRV records

integer

<= 65535

Responses

200

DNS record updated

object

message

required

string

Allowed value: DNS record updated

401

Authentication required

object

error

required

Short error description

string

message

required

Human-readable error message

string

code

required

Machine-readable error code

string

402

Payment required

object

error

required

Short error description

string

message

required

Human-readable error message

string

code

required

Machine-readable error code

string

Headers

PAYMENT-REQUIRED

string

X402 payment requirements encoded as a JSON object

403

Ownership denied

object

error

required

Short error description

string

message

required

Human-readable error message

string

code

required

Machine-readable error code

string

404

Record not found

object

error

required

Short error description

string

message

required

Human-readable error message

string

code

required

Machine-readable error code

string

429

Rate limit exceeded

object

error

required

Short error description

string

message

required

Human-readable error message

string

code

required

Machine-readable error code

string