Skip to main content
These commands do what the History tab of a zone and DNS → Changes do in the dashboard. For how history and change approval work, see History and change approval.

Zone history

rollback asks before it changes anything; pass --yes in scripts. Diffs mark added records with +, removed ones with -, and changed ones with ~ and an arrow to what they became:
How long history is kept (superadmin; 0 is no limit):

Edits that wait for approval

When change approval covers you, an edit doesn’t fail: it ends with a note and exits 0.
With --json, the command prints the API’s 202 answer instead.

Change requests

An approval that conflicts with the zone as it is now fails with the reason, and the request stays pending.

Approval policies

Whose edits wait, for a division (every zone without a policy of its own) or one zone. Flags you leave out keep what the policy has; without flags the command shows the policy.
Roles and API tokens are given by name or id; repeat the flag or separate them with commas.