API changelog
One version number for the whole API (info.version in the OpenAPI file, also returned by GET /v1/health). Changes inside /v1 are additive; see the versioning and deprecation policy in the API reference. Every change to the OpenAPI files gets an entry here in the same change. Versions before 1.2.0 were not recorded.
Format: Added / Changed / Deprecated / Removed.
1.4.0 (2026-11-17)
Added
- Atomic zone changes:
POST /v1/zones/{zone}/batchapplies deletes, patches, puts and posts of one zone in one transaction, with adry_runand acomment. A failed batch lists every failed operation and changes nothing. - RRsets:
GET /v1/zones/{zone}/rrsetsandGET,PUT,DELETE /v1/zones/{zone}/rrsets/{name}/{type}read and replace all values of a name and type at once. dry_run: trueon record create, update and bulk requests, andPOST /v1/zones/{zone}/validateto check up to 500 records against a zone without writing.- Registrar data:
GET /v1/domains/{domain}returns what the registrar knows about a domain registered through us (status, dates, nameservers, transfer lock, WHOIS privacy, and for.plthe holder and DNSSEC records at the registry). Needs thedomains:readscope. - Transfer lock:
PUT /v1/domains/{domain}/transfer-lockswitches the registrar lock of a domain. It needs a signed-in session of the account owner; an API key gets403 JWT_REQUIRED. TLDs without a registrar lock answer409 TRANSFER_LOCK_NOT_SUPPORTED. - API keys:
POST /v1/account/api-keys/{id}/rotateissues a new secret and keeps the old one working for a grace period,GET /v1/account/api-keys/{id}/usageshows how a key was used over the last 30 days, and the owner is reminded by e-mail before a key expires. - Webhooks:
POST /v1/webhooks/{id}/deliveries/{delivery_id}/redeliverandGET /v1/webhooks/{id}/deliveries/{delivery_id}, azonesfilter,data.before,data.afteranddata.actorin events, and the new eventszone.batch_appliedandrrset.updated. The delivery policy (5 attempts, 10 s timeout) is part of the reference. - Rate limits:
GET /v1/account/limitsshows what is left in each bucket. Changes, reads, zone imports, bulk requests and domain checks have separate buckets, and every429names its bucket. TheRateLimitandRateLimit-Policyheaders are sent next toX-RateLimit-*. - Lists:
include=total, aLink: rel="next"header, and cursor pagination on the payment lists. - Null MX (RFC 7505): an
MXrecord with content.and priority 0 says that a domain accepts no mail. It must be the only MX of its name (422 NULL_MX_CONFLICT). - Plan minimum TTL:
min_ttlinGET /v1/plansandGET /v1/account/subscription; a lower TTL is refused with422 TTL_BELOW_PLAN_MINIMUM. - Every error body carries
request_id, the same value as theX-Request-Idheader. - New error codes:
INVALID_PRIO,CONTENT_TOO_LONG,RRSET_TOO_LARGE,NULL_MX_CONFLICT,BATCH_FAILED,TTL_BELOW_PLAN_MINIMUM,RRSET_NOT_FOUND,EMPTY_RRSET,RRSET_SINGLE_VALUE,RRSET_NOT_EDITABLE,TRANSFER_LOCK_NOT_SUPPORTED,REGISTRAR_ERROR.
Deprecated
- The
offsetparameter ofGET /v1/auditand of the payment lists: usecursor. It keeps working for at least 12 months.
Changed
- Request validation is stricter. A request body must be a valid JSON object, fields that take a list must be sent as a list,
limitmust be a whole number, and flags must be JSONtrueorfalse(nullmeans "not sent"). - Record content is checked against size limits (a TXT value up to 4096 bytes, all TXT values of a name together up to 16384 bytes, other types up to 65535 bytes), and priority, port and similar numbers against their ranges. A zone that is not yours answers
403 ACCESS_DENIEDbefore anything else is checked. - An unknown path answers
404 NOT_FOUND, and a known path with a wrong method answers405 METHOD_NOT_ALLOWEDwith anAllowheader. Retry-Afteris the exact number of seconds until a slot frees up.POST /v1/auth/magic-link/requestanswers422 VALIDATION_ERRORfor a value that is not an e-mail address.- OpenAPI descriptions were corrected: documented response codes, limits and nullable fields match what the API does.
1.3.0 (2026-11-02)
Added
GET /v1/domains:renewal({amount, currency}) andregistered_at;DELETE /v1/domains/{domain}acceptsforceastrue/false.- Cursor pagination for lists, record filters and an incremental audit export.
- Apply a template to many zones at once (
POST /v1/templates/{id}/apply, Business plan). - Webhook payloads with
idandversion, more events (includingzone.createdandzone.imported), Slack, Discord, Microsoft Teams and Telegram formats, andPOST /v1/webhooks/{id}/test. - Alert rules for DNS changes (dangling CNAME, record changes, delegation changes) and test endpoints for alerts and e-mail.
- Restricted Mode:
403 ACCOUNT_FROZENfor accounts with an unpaid balance. - Responses: dates in RFC 3339 UTC (
Z), the full resource after a write,X-Request-Idon every response.
Deprecated (not before 2027-11-02)
GET /v1/domains:our(usemanaged_by_us),registered(useregistered_at),renewal_price(userenewal).
1.2.0 (2026-10-21)
Added
- A single API version and an
operationIdon every operation. - A versioning and deprecation policy, with
Deprecation,SunsetandLinkheaders on deprecated routes. soa_serialin record write responses.
Deprecated (sunset 2027-10-21)
POST /v1/domains/check: usePOST /v1/domains/check-single.