DNS

Add a DNS record

Add a record to a zone. MX records require priority.

post/agent/dns/zones/{id}/records

Request

  • Base URL: https://edge.network
  • URL: https://edge.network/agent/dns/zones/{id}/records
  • Auth: HTTP bearer

Path parameters

idstring required

Zone id.

Headers

X-Dry-Run'true' | 'false'

Set to "true" to preview the operation (validation, cost, plan) without making changes.

Idempotency-Keystring

Unique key for safe retries. Repeating a request with the same key returns the original response instead of re-executing.

Request body

type'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS' required
namestring required

"www", "@" for root, etc.

datastring required

IP address, hostname, or text value.

ttlnumber
prioritynumber

Required for MX records.

Response

Success.

tell_userstring

Human-readable summary of what happened, for the agent to relay to its operator.

Changes

No recorded changes to this operation across all 1 revision of this API.