Can I rename an API key after creating it?

Last updated May 20, 2026API

Renaming an API key on Valid Email Checker is a one-click operation, and it does not invalidate the key value. The label you give a key is purely cosmetic — it shows in the Developer table column called API Title — so a rename touches nothing about the key string itself or its usage statistics. Integrations using the old name keep working without modification.

How to rename

  1. Open the Developer page in your dashboard sidebar.
  2. Find the key in the Your API Keys table.
  3. Click the three-dot icon at the far right of that row to open the actions menu.
  4. Click Rename. A small modal appears with the current name pre-filled.
  5. Type the new name and click Save. The table updates in place and a green toast confirms "API key renamed successfully".

What does NOT change when you rename

  • The API key value (the VEC... string) — unchanged. Your applications keep authenticating exactly as before.
  • The credits used counter — preserved. We track usage by key ID, not by name.
  • The created-at timestamp — preserved.
  • The status (active, disabled, suspended) — preserved.
  • Rate-limit and daily-limit counters — preserved.

Naming constraints

  • Names must be unique within your account — the API returns "An API key with this name already exists. Please choose a different name." if you try to reuse one. This applies across active, disabled, and not-yet-deleted keys (deleted keys free up the name).
  • There is no hard character limit enforced in the modal, but keep it short enough to read in the table at a glance. Anything under 40 characters fits comfortably without truncation.
  • Whitespace and most punctuation are allowed. Emoji work too, but we recommend sticking to plain ASCII so terminal logs render cleanly.
Good naming conventions
Pick names that tell future-you what the key is for and where it lives. Production server, Mailchimp middleware, Local dev — laptop, Backfill script Apr 2026. Bad names like key1, test, temp come back to haunt you when you have five of them and cannot remember which is safe to disable.

Renaming vs. regenerating

A rename only changes the label. A regenerate (from the same actions menu) keeps the friendly name but issues a fresh key value, invalidating the old string immediately. Pick rename when the name is wrong; pick regenerate when the key itself has been exposed. See what is the difference between revoking and deleting an API key for the full lifecycle picture.

Bulk renaming

There is no bulk-rename screen — each key is renamed one at a time from its actions menu. If you have many keys to relabel after a naming-convention overhaul, plan a few minutes to click through the list. The Valid Email Checker dashboard does not surface a JSON-import option for key metadata.

Next steps