Replace RRset
desec_replace_rrsetDestructiveIdempotent
WRITE (overwrites): set ONE RRset to exactly the given TTL and records, creating it if it does not exist and REPLACING all its current records if it does. It goes live in DNS immediately; a wrong value can take a site or mail offline. The previous RRset is read first and returned as previous so the change can be undone with another call. An empty record list is refused (this tool never deletes), and the apex NS and DNSSEC records cannot be changed. Subject to deSEC's write limits (15/min, 300/day per domain). PUT /domains/{name}/rrsets/ with a one-element array.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ttl | Yes | TTL in seconds, at most 86400. Not below the domain's minimum_ttl (usually 3600): deSEC rejects lower values. | |
| type | Yes | Record type (uppercase). DNSSEC types and SOA are managed by deSEC and cannot be written. | |
| domain | Yes | Domain name in this deSEC account, e.g. example.com (see desec_list_domains). | |
| records | Yes | Record contents in zone-file format, at least one (an empty list would delete the RRset and is refused). Names need a trailing dot ("10 mx.example.com."), TXT needs quotes ("\"v=spf1 -all\""). | |
| subname | No | Subname relative to the domain: "www", "_443._tcp.www", "*" for a wildcard. Empty or "@" = the zone apex. Never the full name. |