How to Delete a myaddr.tools Registration

Updated

Send a DELETE request to https://myaddr.tools/reg with your key parameter. The registration is removed immediately and permanently, and your name is released back into the pool of available names. There is no undo — if you want the name again later, you have to claim it from scratch and you will receive a new secret key.

What You Need Before Deleting

  • Your secret key. This is the key you received when you first claimed your name. It is the only credential that authorizes changes to your registration, and it cannot be recovered if lost.
  • A decision about whether you actually want to delete. If you only want to stop using the name temporarily, deleting is the wrong move — see the alternative below.

The Deletion Request

The /reg endpoint accepts a DELETE request with your key:

curl -X DELETE "https://myaddr.tools/reg?key=YOUR_SECRET_KEY"

The key can be passed as a URL query parameter. The same key that manages your DNS records through the /update endpoint authorizes deletion here.

What Happens After You Delete

Effect Detail
Registration Removed immediately and permanently
Name Released and becomes available for anyone to claim
DNS records Stop resolving, since the name no longer belongs to you
Recovery Not possible — you would need to re-claim the name and get a new secret key

Because the name is released instantly, someone else could claim it right after you delete. If you have anything pointing at that hostname — a server, a certificate renewal hook, a monitoring check — those references will break.

Before You Delete: Check the Alternative

If your goal is simply to stop the name from expiring on its own, you do not need to delete it. myaddr.tools keeps a registration alive as long as you update each IP address at least once every 90 days, and deletes the registration automatically after 120 days with no updates at all. So if you want to keep the name but stop actively using it, you can let it lapse naturally rather than deleting — though note that letting it lapse has the same end result (the name is released), just on the service's schedule instead of yours.

Deleting manually is the right choice when you want the name gone now and you are certain you will not want it back.

Common Pitfalls

  • Losing the key first. If you no longer have your secret key, you cannot delete the registration through the API. The key is the only proof of ownership.
  • Expecting a confirmation step. The deletion is immediate. There is no grace period or confirmation prompt to catch a mistake.
  • Assuming the name stays reserved. Once released, the name is fair game for anyone. If you plan to re-claim it, do so promptly.