Skip to content

Add a value to a DNS Record Set

POST
/enum.api.v1.DnsService/AddRecordSetValue

AddRecordSetValue adds one value to the (name, type) rrset, creating the set if it does not exist.

object
projectId
string
zoneId
string
name
string
type
string
ttl

Ttl is applied only when the rrset is created; 0 means “use the per-type default”.

integer format: int32
value
object
content

Rdata in presentation format (e.g. “192.0.2.1”, “10 mail.example.com.”).

string
disabled
boolean

OK

object
recordSet

DnsRecordSet is a resource record set: all values sharing (name, type) with one shared TTL. It is addressed by (zone_id, name, type).

object
id
string
zoneId
string
name

Owner name (FQDN, e.g. www.example.com or example.com for apex).

string
type

Record type: A, AAAA, CNAME, MX, TXT, NS, SRV, or CAA. A CNAME at the zone apex flattens to the target’s A/AAAA addresses when served; unlike CNAME elsewhere, it may coexist with MX, TXT, and CAA at the apex (not with A or AAAA).

string
ttl
integer format: int32
records
Array<object>
object
content

Rdata in presentation format (e.g. “192.0.2.1”, “10 mail.example.com.”).

string
disabled
boolean
createdAt
string format: date-time
updatedAt
string format: date-time