Update Record
curl -X POST "https://api.5centscdn.com/v2/dns/example_string/records/example_string" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{
"type": "A",
"ttl": 3600,
"host": "www",
"record": "8.8.8.8",
"priority": "10",
"weight": "10",
"port": "443",
"frame": "N",
"frame_title": "My Site",
"frame_keywords": "cdn, streaming",
"frame_description": "My CDN site",
"mobile_meta": "N",
"save_path": "N",
"redirect_type": "301",
"mail": "mail.example.com",
"txt": "v=spf1 include:example.com ~all",
"algorithm": "13",
"fptype": "2",
"status": "1",
"caa_flag": "0",
"caa_type": "issue",
"caa_value": "letsencrypt.org",
"tlsa_usage": "3",
"tlsa_selector": "1",
"tlsa_matching_type": "1",
"key_tag": "12345",
"digest_type": "2",
"order": "10",
"pref": "10",
"flag": "U",
"params": "SIP+D2U",
"regexp": "",
"replace": "_sip._udp.example.com",
"cert_type": "1",
"cert_key_tag": "0",
"cert_algorithm": "13",
"cpu": "Intel",
"os": "Linux",
"lat_deg": "37",
"lat_min": "46",
"lat_sec": "29",
"lat_dir": "N",
"long_deg": "122",
"long_min": "25",
"long_sec": "9",
"long_dir": "W",
"altitude": "0",
"size": "1",
"h_precision": "10000",
"v_precision": "10",
"smimea_usage": "3",
"smimea_selector": "0",
"smimea_matching_type": "1",
"note": "My primary web server A record"
}'
import requests
import json
url = "https://api.5centscdn.com/v2/dns/example_string/records/example_string"
headers = {
"Content-Type": "application/json",
"X-API-Key": "YOUR_API_KEY"
}
data = {
"type": "A",
"ttl": 3600,
"host": "www",
"record": "8.8.8.8",
"priority": "10",
"weight": "10",
"port": "443",
"frame": "N",
"frame_title": "My Site",
"frame_keywords": "cdn, streaming",
"frame_description": "My CDN site",
"mobile_meta": "N",
"save_path": "N",
"redirect_type": "301",
"mail": "mail.example.com",
"txt": "v=spf1 include:example.com ~all",
"algorithm": "13",
"fptype": "2",
"status": "1",
"caa_flag": "0",
"caa_type": "issue",
"caa_value": "letsencrypt.org",
"tlsa_usage": "3",
"tlsa_selector": "1",
"tlsa_matching_type": "1",
"key_tag": "12345",
"digest_type": "2",
"order": "10",
"pref": "10",
"flag": "U",
"params": "SIP+D2U",
"regexp": "",
"replace": "_sip._udp.example.com",
"cert_type": "1",
"cert_key_tag": "0",
"cert_algorithm": "13",
"cpu": "Intel",
"os": "Linux",
"lat_deg": "37",
"lat_min": "46",
"lat_sec": "29",
"lat_dir": "N",
"long_deg": "122",
"long_min": "25",
"long_sec": "9",
"long_dir": "W",
"altitude": "0",
"size": "1",
"h_precision": "10000",
"v_precision": "10",
"smimea_usage": "3",
"smimea_selector": "0",
"smimea_matching_type": "1",
"note": "My primary web server A record"
}
response = requests.post(url, headers=headers, json=data)
print(response.json())
const response = await fetch("https://api.5centscdn.com/v2/dns/example_string/records/example_string", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-Key": "YOUR_API_KEY"
},
body: JSON.stringify({
"type": "A",
"ttl": 3600,
"host": "www",
"record": "8.8.8.8",
"priority": "10",
"weight": "10",
"port": "443",
"frame": "N",
"frame_title": "My Site",
"frame_keywords": "cdn, streaming",
"frame_description": "My CDN site",
"mobile_meta": "N",
"save_path": "N",
"redirect_type": "301",
"mail": "mail.example.com",
"txt": "v=spf1 include:example.com ~all",
"algorithm": "13",
"fptype": "2",
"status": "1",
"caa_flag": "0",
"caa_type": "issue",
"caa_value": "letsencrypt.org",
"tlsa_usage": "3",
"tlsa_selector": "1",
"tlsa_matching_type": "1",
"key_tag": "12345",
"digest_type": "2",
"order": "10",
"pref": "10",
"flag": "U",
"params": "SIP+D2U",
"regexp": "",
"replace": "_sip._udp.example.com",
"cert_type": "1",
"cert_key_tag": "0",
"cert_algorithm": "13",
"cpu": "Intel",
"os": "Linux",
"lat_deg": "37",
"lat_min": "46",
"lat_sec": "29",
"lat_dir": "N",
"long_deg": "122",
"long_min": "25",
"long_sec": "9",
"long_dir": "W",
"altitude": "0",
"size": "1",
"h_precision": "10000",
"v_precision": "10",
"smimea_usage": "3",
"smimea_selector": "0",
"smimea_matching_type": "1",
"note": "My primary web server A record"
})
});
const data = await response.json();
console.log(data);
package main
import (
"fmt"
"net/http"
"bytes"
"encoding/json"
)
func main() {
data := []byte(`{
"type": "A",
"ttl": 3600,
"host": "www",
"record": "8.8.8.8",
"priority": "10",
"weight": "10",
"port": "443",
"frame": "N",
"frame_title": "My Site",
"frame_keywords": "cdn, streaming",
"frame_description": "My CDN site",
"mobile_meta": "N",
"save_path": "N",
"redirect_type": "301",
"mail": "mail.example.com",
"txt": "v=spf1 include:example.com ~all",
"algorithm": "13",
"fptype": "2",
"status": "1",
"caa_flag": "0",
"caa_type": "issue",
"caa_value": "letsencrypt.org",
"tlsa_usage": "3",
"tlsa_selector": "1",
"tlsa_matching_type": "1",
"key_tag": "12345",
"digest_type": "2",
"order": "10",
"pref": "10",
"flag": "U",
"params": "SIP+D2U",
"regexp": "",
"replace": "_sip._udp.example.com",
"cert_type": "1",
"cert_key_tag": "0",
"cert_algorithm": "13",
"cpu": "Intel",
"os": "Linux",
"lat_deg": "37",
"lat_min": "46",
"lat_sec": "29",
"lat_dir": "N",
"long_deg": "122",
"long_min": "25",
"long_sec": "9",
"long_dir": "W",
"altitude": "0",
"size": "1",
"h_precision": "10000",
"v_precision": "10",
"smimea_usage": "3",
"smimea_selector": "0",
"smimea_matching_type": "1",
"note": "My primary web server A record"
}`)
req, err := http.NewRequest("POST", "https://api.5centscdn.com/v2/dns/example_string/records/example_string", bytes.NewBuffer(data))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
fmt.Println("Response Status:", resp.Status)
}
require 'net/http'
require 'json'
uri = URI('https://api.5centscdn.com/v2/dns/example_string/records/example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request['X-API-Key'] = 'YOUR_API_KEY'
request.body = '{
"type": "A",
"ttl": 3600,
"host": "www",
"record": "8.8.8.8",
"priority": "10",
"weight": "10",
"port": "443",
"frame": "N",
"frame_title": "My Site",
"frame_keywords": "cdn, streaming",
"frame_description": "My CDN site",
"mobile_meta": "N",
"save_path": "N",
"redirect_type": "301",
"mail": "mail.example.com",
"txt": "v=spf1 include:example.com ~all",
"algorithm": "13",
"fptype": "2",
"status": "1",
"caa_flag": "0",
"caa_type": "issue",
"caa_value": "letsencrypt.org",
"tlsa_usage": "3",
"tlsa_selector": "1",
"tlsa_matching_type": "1",
"key_tag": "12345",
"digest_type": "2",
"order": "10",
"pref": "10",
"flag": "U",
"params": "SIP+D2U",
"regexp": "",
"replace": "_sip._udp.example.com",
"cert_type": "1",
"cert_key_tag": "0",
"cert_algorithm": "13",
"cpu": "Intel",
"os": "Linux",
"lat_deg": "37",
"lat_min": "46",
"lat_sec": "29",
"lat_dir": "N",
"long_deg": "122",
"long_min": "25",
"long_sec": "9",
"long_dir": "W",
"altitude": "0",
"size": "1",
"h_precision": "10000",
"v_precision": "10",
"smimea_usage": "3",
"smimea_selector": "0",
"smimea_matching_type": "1",
"note": "My primary web server A record"
}'
response = http.request(request)
puts response.body
{
"status": "Success",
"statusDescription": "The record was updated successfully.",
"data": {
"id": 12345
}
}
/dns/{dnsId}/records/{recordid}Target server for requests. Edit to use your own host.
API key (sent in header)
The media type of the request body
DNS record type. A, AAAA, MX, CNAME, TXT, NS, SRV, and others.
Time to live in seconds. Common values: 60, 300, 3600, 86400.
Hostname or subdomain. Use @ for the root domain.
Record value. IP address for A/AAAA, hostname for CNAME/MX/NS, text for TXT.
Priority for MX or SRV records. Lower value means higher priority.
Weight for SRV records. Used to balance load between equal-priority servers.
Port number for SRV records.
Enable iframe redirect for WR records. Y means enabled, N means disabled.
HTML page title shown when using iframe redirect.
HTML meta keywords for iframe redirect page.
HTML meta description for iframe redirect page.
Add a mobile viewport meta tag. Y means enabled, N means disabled.
Preserve the request path when redirecting. Y means enabled, N means disabled.
HTTP redirect type. 301 means permanent, 302 means temporary.
Mail server hostname for MX records.
TXT record content string.
Algorithm identifier. For SSHFP records: 1=RSA, 2=DSA, 3=ECDSA, 4=Ed25519. For DS/CERT records: 2=DH, 3=DSA/SHA1, 4=ECC, 5=RSASHA1, 6=DSA-NSEC3-SHA1, 7=RSASHA1-NSEC3-SHA1, 8=RSASHA256, 10=RSASHA512, 13=ECDSAP256SHA256, 14=ECDSAP384SHA384, 15=Ed25519, 16=Ed448, 252=INDIRECT, 253=PRIVATEDNS, 254=PRIVATEOID.
Fingerprint hash type for SSHFP records. 1 means SHA-1, 2 means SHA-256.
Record status. 1 means active, 0 means inactive.
CAA record flag controlling certificate authority enforcement. 0 = Non-critical. 28 = Critical.
CAA property tag. Values: issue, issuewild, iodef.
CAA record value. CA domain name or mailto/http URL for iodef.
TLSA certificate usage. 0=PKIX-TA, 1=PKIX-EE, 2=DANE-TA, 3=DANE-EE.
TLSA selector. 0 means full certificate, 1 means public key only.
TLSA matching type. 0 means full data, 1 means SHA-256, 2 means SHA-512.
Key tag for DS records. Identifies the referenced DNSKEY record.
DS record digest algorithm. 1 = SHA-1. 2 = SHA-256. 3 = GOST R 34.11-94. 4 = SHA-384.
Processing order for NAPTR records. Lower value is processed first.
Preference for NAPTR records with equal order. Lower value is preferred.
Flag for NAPTR records. 'Empty Flag' = no replacement (pass to next rule). U = terminal URI. S = terminal SRV lookup. A = terminal A/AAAA lookup. P = provider-specific.
Service parameters for NAPTR records.
Regular expression substitution for NAPTR records.
Replacement FQDN for NAPTR records.
CERT record certificate type. 1=PKIX, 2=SPKI, 3=PGP, 4=IPKIX, 5=ISPKI, 6=IPGP, 7=ACPKIX, 8=IACPKIX, 253=URI, 254=OID.
Key tag for CERT records.
CERT record cryptographic algorithm. 2=DH, 3=DSA/SHA1, 4=ECC, 5=RSASHA1, 6=DSA-NSEC3-SHA1, 7=RSASHA1-NSEC3-SHA1, 8=RSASHA256, 10=RSASHA512, 13=ECDSAP256SHA256, 14=ECDSAP384SHA384, 15=Ed25519, 16=Ed448, 252=INDIRECT, 253=PRIVATEDNS, 254=PRIVATEOID.
CPU type identifier for HINFO records.
Operating system identifier for HINFO records.
Latitude degrees for LOC records. Range 0-90.
Latitude minutes for LOC records. Range 0-59.
Latitude seconds for LOC records. Range 0-59.999.
Latitude direction for LOC records. N or S.
Longitude degrees for LOC records. Range 0-180.
Longitude minutes for LOC records. Range 0-59.
Longitude seconds for LOC records. Range 0-59.999.
Longitude direction for LOC records. E or W.
Altitude in metres for LOC records.
Size of the location in metres for LOC records.
Horizontal precision in metres for LOC records.
Vertical precision in metres for LOC records.
S/MIME certificate usage. 0=PKIX-TA, 1=PKIX-EE, 2=DANE-TA, 3=DANE-EE.
S/MIME selector. 0 means full certificate, 1 means public key only.
S/MIME matching type. 0 means full data, 1 means SHA-256, 2 means SHA-512.
Optional free-text note or comment attached to this DNS record.
Request Preview
Response
Response will appear here after sending the request
Authentication
API Key for authentication. Provide your API key in the header.
Path Parameters
Body
Record value. IP address for A/AAAA, hostname for CNAME/MX/NS, text for TXT.
8.8.8.8Preserve the request path when redirecting. Y means enabled, N means disabled.
NAlgorithm identifier. For SSHFP records: 1=RSA, 2=DSA, 3=ECDSA, 4=Ed25519. For DS/CERT records: 2=DH, 3=DSA/SHA1, 4=ECC, 5=RSASHA1, 6=DSA-NSEC3-SHA1, 7=RSASHA1-NSEC3-SHA1, 8=RSASHA256, 10=RSASHA512, 13=ECDSAP256SHA256, 14=ECDSAP384SHA384, 15=Ed25519, 16=Ed448, 252=INDIRECT, 253=PRIVATEDNS, 254=PRIVATEOID.
13CAA record flag controlling certificate authority enforcement. 0 = Non-critical. 28 = Critical.
028CAA record value. CA domain name or mailto/http URL for iodef.
letsencrypt.orgTLSA matching type. 0 means full data, 1 means SHA-256, 2 means SHA-512.
1DS record digest algorithm. 1 = SHA-1. 2 = SHA-256. 3 = GOST R 34.11-94. 4 = SHA-384.
1234Flag for NAPTR records. 'Empty Flag' = no replacement (pass to next rule). U = terminal URI. S = terminal SRV lookup. A = terminal A/AAAA lookup. P = provider-specific.
Empty FlagUSAPCERT record certificate type. 1=PKIX, 2=SPKI, 3=PGP, 4=IPKIX, 5=ISPKI, 6=IPGP, 7=ACPKIX, 8=IACPKIX, 253=URI, 254=OID.
1CERT record cryptographic algorithm. 2=DH, 3=DSA/SHA1, 4=ECC, 5=RSASHA1, 6=DSA-NSEC3-SHA1, 7=RSASHA1-NSEC3-SHA1, 8=RSASHA256, 10=RSASHA512, 13=ECDSAP256SHA256, 14=ECDSAP384SHA384, 15=Ed25519, 16=Ed448, 252=INDIRECT, 253=PRIVATEDNS, 254=PRIVATEOID.
13S/MIME matching type. 0 means full data, 1 means SHA-256, 2 means SHA-512.
1Optional free-text note or comment attached to this DNS record.
My primary web server A recordResponses
Operation outcome.
Human-readable description of the operation outcome.
Response data payload.
Unique identifier of the updated DNS record.