Skip to content

Knowledgebase

Reverse a DNS changeset after comparing the current zone

domain-nexus, development

A changeset reversal is another controlled DNS change. It uses recovery evidence and still has to account for the zone's current state. Do not assume a reversal can erase every later edit or recover a website database, registrar action or provider-specific setting.

01 Review before reverting

Method Resource Scope Idempotency-Key
GET /v2/dns/changesets/{changesetId} dns:read Not required by this route
POST /v2/dns/changesets/{changesetId}/revert dns:write Required
  1. Identify the original changeset and confirm which record changes caused the problem.
  2. Read the current zone and compare it with the before-and-after evidence for that changeset.
  3. Check for later legitimate edits, provider drift, ownership changes or a migration that could make an automatic reversal conflict with the current service.
  4. Keep a current export or backup so the recovery attempt itself has a clear starting point.
  5. Submit the revert request with the required idempotency key only when the reviewed recovery action is appropriate.
  6. Follow the returned task and inspect provider readback, authoritative answers and affected website or mail behaviour.

Why might a reversal need manual review?

The target may have changed since the original action, a provider may no longer support the same operation, or the record may now be protected by an ownership or lifecycle condition. A conflict is useful evidence that the saved inverse is not automatically safe to apply.

Can I restore just one record instead?

When only one value needs correction, a fresh explicit changeset based on the current zone may be clearer than reverting a broad earlier change. Review both approaches and choose the smallest accurate recovery for the actual incident.

Does revert remove cached answers?

No. Even after authoritative DNS is restored, recursive resolvers may retain a previously cached value until its applicable TTL expires. Verify the authoritative result first, then distinguish remaining caching from an unresolved provider error.

If the revert request times out, inspect its existing task before sending another mutation. Keep the original and recovery references together so support can reconstruct what was intended and which changes actually reached the provider.

Was this answer helpful?

Need a little more help?

Our support team can help you find the next step.

Contact support