Keys

Rename an API key

Changes the label only. A key's scopes are fixed for its life: the secret is bound to the grants it was minted with, so widening one in place would give new reach to every holder of a credential issued narrow. To change what a key may do, mint its replacement and revoke it. A key may rename itself.

put/v1/keys/{key_id}

Request

  • Base URL: https://dnsmint.com/api
  • URL: https://dnsmint.com/api/v1/keys/{key_id}
  • Auth: HTTP bearer

Path parameters

key_idstring required

The key id, as it appears in dnsm_<key_id>_<secret>.

Request body

namestring required

The new label. Trimmed, and truncated to 60 characters. Must not be blank.

Response

Renamed

key_idstring
namestring

Changes

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