Domains

Remove left-over DNS records in one step

Removes the records labeled safe_to_remove, minus exclude_record_ids, plus the ask-records in include_record_ids, in one step. The suggestion is made again at that moment; a record labeled keep is never removed (422). Before anything is removed, the records are written to the audit log as a zone file; the answer has the same zone_file and a cleanup_id. For 30 days the cleanup can be undone with POST /domains/{id}/dns-cleanup/restore.

post/domains/{id}/dns-cleanup

Request

  • Base URL: https://api.hypamoon.com/api/v1
  • URL: https://api.hypamoon.com/api/v1/domains/{id}/dns-cleanup
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.hypamoon.com/oauth/authorize, token URL https://api.hypamoon.com/oauth/token, scopes: sites:write)

Path parameters

idstring uuid required

The id of the domain.

Request body

include_record_idsstring[]

Optional. Records labeled ask (from get_dns_cleanup) that the user chose to remove too. Records labeled keep are never removed; naming one is refused.

exclude_record_idsstring[]

Optional. Records labeled safe_to_remove that the user wants to keep this time.

Response

What was removed, what failed, the zone file and until when it can be restored.

Changes

No recorded changes to this operation across all 1 revision of this API.