Chapter 10: Controller: /nodeworx/dns Up Part II: NodeWorx API Spec Chapter 12: Controller: /nodeworx/dns/sync 

11 Controller: /nodeworx/dns/record

Required Permissions "DNS"
Action: add
Added in version 4.7.0-339
Description Add a DNS record.
Warning This action has been deprecated as of version 4.8.0-393. 2011-02-23 Use the individual add(record-type) functions instead.
Input Parameters
Name Type Notes Required?
zone_id integer Yes
host string Yes
type string Example Values
A, CNAME, NS, MX, PTR, TXT, SOA, SPF, SRV, AAAA, NAPTR, CAA
Yes
target string Yes
ttl integer Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Yes
Action: addA
Added in version 4.7.0-339
Description Add an A record to a zone.
Input Parameters
Name Type Notes Required?
zone_id integer Yes
host string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
ipaddress string Help Entry
####
Yes
* indicates that it’s actually required, but probably already has a valid default value
Action: addAAAA
Added in version 4.8.0-393
Description Add an AAAA record to a zone.
Input Parameters
Name Type Notes Required?
zone_id integer Yes
host string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
ipaddress string Help Entry
####
Yes
* indicates that it’s actually required, but probably already has a valid default value
Action: addCAA
Added in version 6.0.8-1363
Description Add a CAA record to a zone.
Input Parameters
Name Type Notes Required?
zone_id integer Yes
domain string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
flags integer Help Entry
Issuer Critical Flag: If the "flags" value is set to ’1’, the critical flag is asserted and the property MUST be understood if the CAA record is to be correctly processed by a certificate issuer. A Certification Authority MUST NOT issue certificates for any Domain that contains a CAA critical property for an unknown or unsupported property tag that for which the issuer critical flag is set. See: RFC6844
Example Values
0, 128
Example Default Value
0
No*
tag string Help Entry
Property tags define the meaning of the CAA record. Three are currently supported, but more may be added in the future.<br/><br/><b>issue:</b>This tag is used to allow/disallow the Certificate Authority to issue certificates for the domain, including wildcard certificates.<br/><br/><b>issuewild: </b>This tag is used to allow/disallow wildcard certificates issuance for the domain.<br/><br/><b>iodef: </b>This tag specifies a method for CAs to report to the domain holder when a certificate is issued. Not all CAs support this tag, so there is no guarantee that all certificate issuances will be reported.<br/><br/>
Example Values
issue, issuewild, iodef
Example Default Value
issue
No*
issue string Help Entry
Enter the domain of the Certificate authority (ex. letsencrypt.org). To prevent Certificate Authorities from issuing certificates for this tag enter a semicolon (;).
Example Values
comodoca.com, digicert.com, entrust.net, globalsign.com, izenpe.com, letsencrypt.org, symantec.com, trustwave.com, wosign.com, ;
No
issuewild string Help Entry
Enter the domain of the Certificate authority (ex. letsencrypt.org). To prevent Certificate Authorities from issuing certificates for this tag enter a semicolon (;).
Example Values
comodoca.com, digicert.com, entrust.net, globalsign.com, izenpe.com, letsencrypt.org, symantec.com, trustwave.com, wosign.com, ;
No
iodef string Help Entry
Enter an email address or url to receive IODEF incident reports. See <a href="https://tools.ietf.org/html/rfc6546">[RFC6546]</a> for more information regarding url reporting.
No
* indicates that it’s actually required, but probably already has a valid default value
Action: addCNAME
Added in version 4.8.0-393
Description Add a CNAME record to a zone.
Input Parameters
Name Type Notes Required?
zone_id integer Yes
host string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
alias string Yes
* indicates that it’s actually required, but probably already has a valid default value
Action: addMX
Added in version 4.8.0-393
Description Add an MX record to a zone.
Input Parameters
Name Type Notes Required?
zone_id integer Yes
host string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
preference integer Help Entry
An integer, ranging from 0-65535, indicating the order in which records should be attempted. Lower numbers will be processed before higher ones.
Yes
mail_server string Yes
* indicates that it’s actually required, but probably already has a valid default value
Action: addNAPTR
Added in version 4.8.0-393
Description Add an NAPTR record to a zone.
Input Parameters
Name Type Notes Required?
zone_id integer Yes
domain string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
order integer Help Entry
An integer, ranging from 0-65535, indicating the order in which records MUST be processed by a client. Lower numbers will be processed before higher ones. Once a client has matched a record, that client will stop looking for records with a higher order.
Example Default Value
10
No*
preference integer Help Entry
An integer, ranging from 0-65535, indicating the order in which records SHOULD be processed by a client. Lower numbers will be processed before higher ones. Once a client has matched a record, that client may consider records with a higher Preference. This is similar to the preference of an MX record.
Example Default Value
100
No*
flag string Example Values
S, A, U, P
Yes
service string No
regex string No
replacement string Help Entry
The next name to query for additional records. This must be a Fully Qualified Domain Name (FQDN).
No
* indicates that it’s actually required, but probably already has a valid default value
Action: addNS
Added in version 4.8.0-393
Description Add an NS record to a zone.
Input Parameters
Name Type Notes Required?
zone_id integer Yes
host string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
nameserver string Yes
* indicates that it’s actually required, but probably already has a valid default value
Action: addPTR
Added in version 4.8.0-393
Description Add a PTR record to a zone.
Input Parameters
Name Type Notes Required?
zone_id integer Yes
ip_data string Help Entry
The IP Data for a PTR record can be entered in several formats.<ul><li>Normal IPv4 - 1.2.3.4</li><li>Normal IPv6 - beef::12fe</li><li>Hostname - 4.3.2.1.in-addr.arpa</li><li>RFC4183-style - 4.3/29.2.1.in-addr.arpa</li></ul>
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
domain string Example Default Value
{domain}
No*
* indicates that it’s actually required, but probably already has a valid default value
Action: addSOA
Added in version 4.8.0-393
Description Add an SOA record to a zone.
Input Parameters
Name Type Notes Required?
zone_id integer Yes
host string Example Default Value
{domain}
No*
nameserver string Help Entry
Enter the primary nameserver of your domain. This will almost always be handled automatically for you when creating SiteWorx accounts, and you are urged to only alter this value if you know what you are doing. This nameserver is listed on your SOA record for this domain, and setting it to an incorrect value could cause your site or any of your DNS records not to function properly.
Yes
email string Help Entry
This is the e-mail address listed on your SOA record. Enter it as a normal e-mail address (user@domain.com) and not in the typical SOA style of (user.domain.com).
Yes
refresh integer Description
In Seconds
Help Entry
Sets the number of seconds that a slave will cache the record before re-checking the primary server. Recommended values are between 1200 (twenty minutes) and 43200 (twelve hours).
Yes
retry integer Description
In Seconds
Help Entry
Set the number of seconds to retry a refresh after the previous refresh attempt fails. Recommended values are between 180 (three minutes) and 900 (fifteen minutes).
Yes
expiration integer Description
In Seconds
Help Entry
Set the number of seconds for refresh and retry attempts before the server will stop serving the zone. Per RFC 1912, recommended values are between 1209600 (two weeks) and 2419200 (four weeks). This value is only used by slave servers.
Yes
negative_ttl integer Description
In Seconds
Help Entry
Time in seconds for negative answers (NXDOMAIN) from this zone. This field was redefined in 1998 by RFC2308. Suggested values are between 3600 (one hour) and 10800 (three hours). Values higher than 86400 (twenty-four hours) should be avoided.
Yes
* indicates that it’s actually required, but probably already has a valid default value
Action: addSPF
Added in version 4.8.0-393
Description Add an SPF record to a zone.
Input Parameters
Name Type Notes Required?
zone_id integer Yes
host string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
spf_record_value string No
spf_version string Example Values
v=spf1, v=spf3
Example Default Value
v=spf1
No*
use_a integer Description
Should the IP(s) referenced in DNS A Records for this domain be permitted to send mail?
Example Values
1, 0
Example Default Value
0
No*
use_mx integer Description
Should the hostnames referenced in DNS MX Records for this domain be permitted to send mail?
Example Values
1, 0
Example Default Value
0
No*
use_ptr integer Description
Should the PTR Records for the sender’s IP be used to validate the sender’s domain? NOT RECOMMENDED.
Example Values
1, 0
Example Default Value
0
No*
other_servers integer Description
Do any other hostnames or IPs need to be authorized to send mail for this domain?
Example Values
1, 0
Example Default Value
0
No*
mechanism_a struct (string) Description
If the domain name has an address record (A or AAAA) that can be resolved to the sender’s address, it will match.
No
mechanism_mx struct (string) Description
If the domain name has an MX record resolving to the sender’s address, it will match (i.e. the mail comes from one of the domain’s mail servers).
No
mechanism_ip4 struct (string) Description
If the sender is in a given IPv4 range, match.
No
mechanism_ip6 struct (string) Description
If the sender is in a given IPv6 range, match.
No
mechanism_ptr struct (string) Description
If the domain name for the client’s address is in the given domain and that domain name resolves to the client’s address, match. Input may use macro-expansion. NOT RECOMMENDED.
No
mechanism_exists struct (string) Description
If there is a valid A Record for the given domain, match. Input may use macro-expansion.
No
mechanism_include struct (string) Description
Used to include the policies of another domain’s SPF record. Similar to the ’Redirect’ parameter.
No
all string Description
Defines how to respond if the record has produced no match.
Example Values
, -all, ~all, ?all, +all
No
redirect string Description
Redirects verification to use the SPF record of the specified domain. This is useful, for example, if you send mail through your ISP’s servers and they have defined an SPF record.
No
explanation string Description
Defines a DNS name whose TXT Record may be returned along with failure messages. Rarely used, may not be universally supported.
No
* indicates that it’s actually required, but probably already has a valid default value
Action: addSRV
Added in version 4.8.0-393
Description Add an SRV record to a zone.
Input Parameters
Name Type Notes Required?
zone_id integer Yes
service string Help Entry
The symbolic name of the desired service. For example, _sip, _ldap, etc.
Yes
protocol string Help Entry
The name of the protocol with an underscore prepended to avoid collisions with other DNS records. "_TCP" and "_UDP" are the two most common values.
Yes
domain string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
priority integer Yes
weight integer Yes
port integer Yes
target string Yes
* indicates that it’s actually required, but probably already has a valid default value
Action: addTXT
Added in version 4.8.0-393
Description Add a TXT record to a zone.
Input Parameters
Name Type Notes Required?
zone_id integer Yes
host string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
text string Yes
* indicates that it’s actually required, but probably already has a valid default value
Action: delete
Added in version 4.7.0-339
Description Delete a DNS record.
Input Parameters
Name Type Notes Required?
record_id struct (integer) Yes
Action: edit
Added in version 4.7.0-339
Description Edit a DNS record.
Warning This action has been deprecated as of version 4.8.0-393. 2011-02-23 Use the individual edit(record-type) functions instead.
Input Parameters
Name Type Notes Required?
record_id integer Yes
host string Example Default Value
{domain}
No*
type string Example Values
A, CNAME, NS, MX, PTR, TXT, SOA, SPF, SRV, AAAA, NAPTR, CAA
Example Default Value
SOA
No*
target string Example Default Value
{domain} testmaster@{domain} 7200 300 1209600 10800
No*
ttl integer Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
* indicates that it’s actually required, but probably already has a valid default value
Action: editA
Added in version 4.7.0-339
Description Edit an A record.
Input Parameters
Name Type Notes Required?
record_id integer Yes
host string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
ipaddress string Help Entry
####
Example Default Value
{ipv4}
No*
* indicates that it’s actually required, but probably already has a valid default value
Action: editAAAA
Added in version 4.8.0-393
Description Edit an AAAA record.
Input Parameters
Name Type Notes Required?
record_id integer Yes
host string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
ipaddress string Help Entry
####
Example Default Value
{ipv6}
No*
* indicates that it’s actually required, but probably already has a valid default value
Action: editCAA
Added in version 6.0.8-1363
Description Edit a CAA record.
Input Parameters
Name Type Notes Required?
record_id integer Yes
domain string Example Default Value
example.com
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
flags integer Help Entry
Issuer Critical Flag: If the "flags" value is set to ’1’, the critical flag is asserted and the property MUST be understood if the CAA record is to be correctly processed by a certificate issuer. A Certification Authority MUST NOT issue certificates for any Domain that contains a CAA critical property for an unknown or unsupported property tag that for which the issuer critical flag is set. See: RFC6844
Example Values
0, 128
Example Default Value
0
No*
tag string Help Entry
Property tags define the meaning of the CAA record. Three are currently supported, but more may be added in the future.<br/><br/><b>issue:</b>This tag is used to allow/disallow the Certificate Authority to issue certificates for the domain, including wildcard certificates.<br/><br/><b>issuewild: </b>This tag is used to allow/disallow wildcard certificates issuance for the domain.<br/><br/><b>iodef: </b>This tag specifies a method for CAs to report to the domain holder when a certificate is issued. Not all CAs support this tag, so there is no guarantee that all certificate issuances will be reported.<br/><br/>
Example Values
issue, issuewild, iodef
Example Default Value
issue
No*
issue string Help Entry
Enter the domain of the Certificate authority (ex. letsencrypt.org). To prevent Certificate Authorities from issuing certificates for this tag enter a semicolon (;).
Example Values
comodoca.com, digicert.com, entrust.net, globalsign.com, izenpe.com, letsencrypt.org, symantec.com, trustwave.com, wosign.com, ;
Example Default Value
ca.example.net
No
issuewild string Help Entry
Enter the domain of the Certificate authority (ex. letsencrypt.org). To prevent Certificate Authorities from issuing certificates for this tag enter a semicolon (;).
Example Values
comodoca.com, digicert.com, entrust.net, globalsign.com, izenpe.com, letsencrypt.org, symantec.com, trustwave.com, wosign.com, ;
No
iodef string Help Entry
Enter an email address or url to receive IODEF incident reports. See <a href="https://tools.ietf.org/html/rfc6546">[RFC6546]</a> for more information regarding url reporting.
No
* indicates that it’s actually required, but probably already has a valid default value
Action: editCNAME
Added in version 4.8.0-393
Description Edit a CNAME record.
Input Parameters
Name Type Notes Required?
record_id integer Yes
host string Example Default Value
www.{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
alias string Example Default Value
{domain}
No*
* indicates that it’s actually required, but probably already has a valid default value
Action: editMX
Added in version 4.8.0-393
Description Edit a MX record.
Input Parameters
Name Type Notes Required?
record_id integer Yes
host string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
preference integer Help Entry
An integer, ranging from 0-65535, indicating the order in which records should be attempted. Lower numbers will be processed before higher ones.
Example Default Value
10
No*
mail_server string Example Default Value
mail.{domain}
No*
* indicates that it’s actually required, but probably already has a valid default value
Action: editNAPTR
Added in version 4.8.0-393
Description Edit a NAPTR record.
Input Parameters
Name Type Notes Required?
record_id integer Yes
domain string Example Default Value
example.com
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
order integer Help Entry
An integer, ranging from 0-65535, indicating the order in which records MUST be processed by a client. Lower numbers will be processed before higher ones. Once a client has matched a record, that client will stop looking for records with a higher order.
Example Default Value
10
No*
preference integer Help Entry
An integer, ranging from 0-65535, indicating the order in which records SHOULD be processed by a client. Lower numbers will be processed before higher ones. Once a client has matched a record, that client may consider records with a higher Preference. This is similar to the preference of an MX record.
Example Default Value
100
No*
flag string Example Values
S, A, U, P
Example Default Value
S
No*
service string No
regex string Example Default Value
!^.*$!sip:info@example.com!
No
replacement string Help Entry
The next name to query for additional records. This must be a Fully Qualified Domain Name (FQDN).
Example Default Value
_sip._udp.example.com
No
* indicates that it’s actually required, but probably already has a valid default value
Action: editNS
Added in version 4.8.0-393
Description Edit a NS record.
Input Parameters
Name Type Notes Required?
record_id integer Yes
host string Example Default Value
{domain}
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
nameserver string Example Default Value
ns1.interworx.com
No*
* indicates that it’s actually required, but probably already has a valid default value
Action: editPTR
Added in version 4.8.0-393
Description Edit a PTR record.
Input Parameters
Name Type Notes Required?
record_id integer Yes
ip_data string Help Entry
The IP Data for a PTR record can be entered in several formats.<ul><li>Normal IPv4 - 1.2.3.4</li><li>Normal IPv6 - beef::12fe</li><li>Hostname - 4.3.2.1.in-addr.arpa</li><li>RFC4183-style - 4.3/29.2.1.in-addr.arpa</li></ul>
Example Default Value
4.3.2.1.in-addr.arpa
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
domain string Example Default Value
example.com
No*
* indicates that it’s actually required, but probably already has a valid default value
Action: editSOA
Added in version 4.8.0-393
Description Edit an SOA record.
Input Parameters
Name Type Notes Required?
record_id integer Yes
nameserver string Help Entry
Enter the primary nameserver of your domain. This will almost always be handled automatically for you when creating SiteWorx accounts, and you are urged to only alter this value if you know what you are doing. This nameserver is listed on your SOA record for this domain, and setting it to an incorrect value could cause your site or any of your DNS records not to function properly.
Example Default Value
{domain}
No*
email string Help Entry
This is the e-mail address listed on your SOA record. Enter it as a normal e-mail address (user@domain.com) and not in the typical SOA style of (user.domain.com).
Example Default Value
testmaster@{domain}
No*
refresh integer Description
In Seconds
Help Entry
Sets the number of seconds that a slave will cache the record before re-checking the primary server. Recommended values are between 1200 (twenty minutes) and 43200 (twelve hours).
Example Default Value
7200
No*
retry integer Description
In Seconds
Help Entry
Set the number of seconds to retry a refresh after the previous refresh attempt fails. Recommended values are between 180 (three minutes) and 900 (fifteen minutes).
Example Default Value
300
No*
expiration integer Description
In Seconds
Help Entry
Set the number of seconds for refresh and retry attempts before the server will stop serving the zone. Per RFC 1912, recommended values are between 1209600 (two weeks) and 2419200 (four weeks). This value is only used by slave servers.
Example Default Value
1209600
No*
negative_ttl integer Description
In Seconds
Help Entry
Time in seconds for negative answers (NXDOMAIN) from this zone. This field was redefined in 1998 by RFC2308. Suggested values are between 3600 (one hour) and 10800 (three hours). Values higher than 86400 (twenty-four hours) should be avoided.
Example Default Value
10800
No*
* indicates that it’s actually required, but probably already has a valid default value
Action: editSPF
Added in version 4.8.0-393
Description Edit an SPF record.
Input Parameters
Name Type Notes Required?
record_id integer Yes
host string Example Default Value
example.com
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
spf_record_value string Example Default Value
v=spf1
No
spf_version string Example Values
v=spf1, v=spf3
Example Default Value
v=spf1
No*
use_a integer Description
Should the IP(s) referenced in DNS A Records for this domain be permitted to send mail?
Example Values
1, 0
Example Default Value
0
No*
use_mx integer Description
Should the hostnames referenced in DNS MX Records for this domain be permitted to send mail?
Example Values
1, 0
Example Default Value
0
No*
use_ptr integer Description
Should the PTR Records for the sender’s IP be used to validate the sender’s domain? NOT RECOMMENDED.
Example Values
1, 0
Example Default Value
0
No*
other_servers integer Description
Do any other hostnames or IPs need to be authorized to send mail for this domain?
Example Values
1, 0
Example Default Value
0
No*
mechanism_a struct (string) Description
If the domain name has an address record (A or AAAA) that can be resolved to the sender’s address, it will match.
No
mechanism_mx struct (string) Description
If the domain name has an MX record resolving to the sender’s address, it will match (i.e. the mail comes from one of the domain’s mail servers).
No
mechanism_ip4 struct (string) Description
If the sender is in a given IPv4 range, match.
No
mechanism_ip6 struct (string) Description
If the sender is in a given IPv6 range, match.
No
mechanism_ptr struct (string) Description
If the domain name for the client’s address is in the given domain and that domain name resolves to the client’s address, match. Input may use macro-expansion. NOT RECOMMENDED.
No
mechanism_exists struct (string) Description
If there is a valid A Record for the given domain, match. Input may use macro-expansion.
No
mechanism_include struct (string) Description
Used to include the policies of another domain’s SPF record. Similar to the ’Redirect’ parameter.
No
all string Description
Defines how to respond if the record has produced no match.
Example Values
, -all, ~all, ?all, +all
No
redirect string Description
Redirects verification to use the SPF record of the specified domain. This is useful, for example, if you send mail through your ISP’s servers and they have defined an SPF record.
No
explanation string Description
Defines a DNS name whose TXT Record may be returned along with failure messages. Rarely used, may not be universally supported.
No
* indicates that it’s actually required, but probably already has a valid default value
Action: editSRV
Added in version 4.8.0-393
Description Edit an SRV record.
Input Parameters
Name Type Notes Required?
record_id integer Yes
service string Help Entry
The symbolic name of the desired service. For example, _sip, _ldap, etc.
Example Default Value
_sip
No*
protocol string Help Entry
The name of the protocol with an underscore prepended to avoid collisions with other DNS records. "_TCP" and "_UDP" are the two most common values.
Example Default Value
_tcp
No*
domain string Example Default Value
example.com
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
priority integer Example Default Value
10
No*
weight integer Example Default Value
100
No*
port integer Example Default Value
5060
No*
target string Example Default Value
www.google.com
No*
* indicates that it’s actually required, but probably already has a valid default value
Action: editTXT
Added in version 4.8.0-393
Description Edit a TXT record.
Input Parameters
Name Type Notes Required?
record_id integer Yes
host string Example Default Value
example.com
No*
ttl integer Description
In Seconds
Help Entry
TTL, or Time To Live, is the number of seconds that a record will be considered valid by a server caching the information.
Example Default Value
43200
No*
text string Example Default Value
example text record
No*
* indicates that it’s actually required, but probably already has a valid default value
Action: listRecordIds
Added in version 4.7.0-339
Description List dns records by id.
Warning This action has been deprecated as of version 4.1.0-247. 2009-12-07 use listRecords
Sample output
array (
’status’ => 0,
’payload’ =>
array (
0 =>
array (
0 => ’1’,
1 => ’{domain} | SOA | {domain} testmaster@{domain} 7200 300 1209600 10800’,
),
1 =>
array (
0 => ’2’,
1 => ’{domain} | A | {ipv4}’,
),
2 =>
array (
0 => ’3’,
1 => ’ipv4.{domain} | A | {ipv4}’,
),
),
)
Action: listRecords
Added in version 4.7.0-339
Description List dns records by id.
Sample output
array (
’status’ => 0,
’payload’ =>
array (
0 =>
array (
’record_id’ => ’2’,
’zone_id’ => ’1’,
’domain’ => ’1.dns-template.com’,
’type’ => ’A’,
’host’ => ’{domain}’,
’target’ => ’{ipv4}’,
’ttl’ => ’43200’,
’last_update’ => ’1417708438’,
’is_template’ => ’1’,
),
1 =>
array (
’record_id’ => ’3’,
’zone_id’ => ’1’,
’domain’ => ’1.dns-template.com’,
’type’ => ’A’,
’host’ => ’ipv4.{domain}’,
’target’ => ’{ipv4}’,
’ttl’ => ’43200’,
’last_update’ => ’1417708438’,
’is_template’ => ’1’,
),
2 =>
array (
’record_id’ => ’9’,
’zone_id’ => ’1’,
’domain’ => ’1.dns-template.com’,
’type’ => ’A’,
’host’ => ’mail.{domain}’,
’target’ => ’{ipv4}’,
’ttl’ => ’43200’,
’last_update’ => ’1417708438’,
’is_template’ => ’1’,
),
),
)
Action: queryEditA
Added in version 5.1.0-838
Description Displays the information available to the action "editA".
Input Parameters
Name Type Notes Required?
record_id integer Yes
Sample output
array (
’status’ => 0,
’payload’ =>
array (
’host’ => ’1.dns-template.com’,
’ttl’ => ’43200’,
’ipaddress’ => ’1.1.1.1’,
’record_id’ => ’2’,
),
)
Action: queryEditAAAA
Added in version 5.1.0-838
Description Displays the information available to the action "editAAAA".
Sample output
array (
’status’ => 0,
’payload’ =>
array (
’host’ => ’1.dns-template.com’,
’ttl’ => ’43200’,
’ipaddress’ => ’1::1’,
’record_id’ => ’4’,
),
)
Action: queryEditCAA
Added in version 6.0.8-1363
Description Displays the information available to the action "editCAA".
Sample output
array (
’status’ => 0,
’payload’ =>
array (
’domain’ => ’example.com’,
’ttl’ => ’43200’,
’flags’ => ’0’,
’tag’ => ’issue’,
’issue’ => ’ca.example.net’,
’issuewild’ => ’’,
’iodef’ => ’’,
’record_id’ => ’8502’,
),
)
Action: queryEditCNAME
Added in version 5.1.0-838
Description Displays the information available to the action "editCNAME".
Sample output
array (
’status’ => 0,
’payload’ =>
array (
’host’ => ’www.1.dns-template.com’,
’ttl’ => ’43200’,
’alias’ => ’1.dns-template.com’,
’record_id’ => ’6’,
),
)
Action: queryEditMX
Added in version 5.1.0-838
Description Displays the information available to the action "editMX".
Sample output
array (
’status’ => 0,
’payload’ =>
array (
’host’ => ’1.dns-template.com’,
’ttl’ => ’43200’,
’preference’ => ’10’,
’mail_server’ => ’mail.1.dns-template.com’,
’record_id’ => ’8’,
),
)
Action: queryEditNAPTR
Added in version 5.1.0-838
Description Displays the information available to the action "editNAPTR".
Sample output
array (
’status’ => 0,
’payload’ =>
array (
’domain’ => ’example.com’,
’ttl’ => ’43200’,
’order’ => ’10’,
’preference’ => ’100’,
’flag’ => ’S’,
’service’ => ’’,
’regex’ => ’!^.*$!sip:info@example.com!’,
’replacement’ => ’_sip._udp.example.com’,
’record_id’ => ’8501’,
),
)
Action: queryEditNS
Added in version 5.1.0-838
Description Displays the information available to the action "editNS".
Sample output
array (
’status’ => 0,
’payload’ =>
array (
’host’ => ’1.dns-template.com’,
’ttl’ => ’43200’,
’nameserver’ => ’ns1.interworx.com’,
’record_id’ => ’506’,
),
)
Action: queryEditPTR
Added in version 5.1.0-838
Description Displays the information available to the action "editPTR".
Sample output
array (
’status’ => 0,
’payload’ =>
array (
’ip_data’ => ’4.3.2.1.in-addr.arpa’,
’ttl’ => ’43200’,
’domain’ => ’example.com’,
’record_id’ => ’8503’,
),
)
Action: queryEditSOA
Added in version 5.1.0-838
Description Displays the information available to the action "editSOA".
Sample output
array (
’status’ => 0,
’payload’ =>
array (
’host’ => ’1.dns-template.com’,
’nameserver’ => ’1.dns-template.com’,
’email’ => ’testmaster@1.dns-template.com’,
’refresh’ => ’7200’,
’retry’ => ’300’,
’expiration’ => ’1209600’,
’negative_ttl’ => ’10800’,
’record_id’ => ’1’,
),
)
Action: queryEditSPF
Added in version 5.1.0-838
Description Displays the information available to the action "editSPF".
Sample output
array (
’status’ => 0,
’payload’ =>
array (
’host’ => ’example.com’,
’ttl’ => ’43200’,
’spf_record_value’ => ’v=spf1’,
’spf_version’ => ’v=spf1’,
’use_a’ => ’0’,
’use_mx’ => ’0’,
’use_ptr’ => ’0’,
’other_servers’ => ’0’,
’mechanism_a’ =>
array (
),
’mechanism_mx’ =>
array (
),
’mechanism_ip4’ =>
array (
),
’mechanism_ip6’ =>
array (
),
’mechanism_ptr’ =>
array (
),
’mechanism_exists’ =>
array (
),
’mechanism_include’ =>
array (
),
’all’ => NULL,
’redirect’ => ’’,
’explanation’ => NULL,
’record_id’ => ’8504’,
),
)
Action: queryEditSRV
Added in version 5.1.0-838
Description Displays the information available to the action "editSRV".
Sample output
array (
’status’ => 0,
’payload’ =>
array (
’service’ => ’_sip’,
’protocol’ => ’_tcp’,
’domain’ => ’example.com’,
’ttl’ => ’43200’,
’priority’ => ’10’,
’weight’ => ’100’,
’port’ => ’5060’,
’target’ => ’www.google.com’,
’record_id’ => ’8505’,
),
)
Action: queryEditTXT
Added in version 5.1.0-838
Description Displays the information available to the action "editTXT".
Sample output
array (
’status’ => 0,
’payload’ =>
array (
’host’ => ’example.com’,
’ttl’ => ’43200’,
’text’ => ’example text record’,
’record_id’ => ’8506’,
),
)
Action: queryRecords
Added in version 4.7.0-339
Description Query DNS Records.
Input Parameters
Name Type Notes Required?
zone_id integer No
domain struct (string) Example Values
example.com, pointer.com, secondary.com
No
type struct (string) Example Values
A, CNAME, NS, MX, PTR, TXT, SOA, SPF, SRV, AAAA, NAPTR, CAA
No
last_update string No
uni integer Example Values
1, 0
Example Default Value
0
No*
show_domain integer Example Values
1, 0
Example Default Value
1
No*
* indicates that it’s actually required, but probably already has a valid default value
 Chapter 10: Controller: /nodeworx/dns Up Part II: NodeWorx API Spec Chapter 12: Controller: /nodeworx/dns/sync 

(C) 2017 by InterWorx LLC