dns
ddns

Claim a free Dynamic DNS hostname

Claim a free hostname under a Namefi-owned parent domain and receive Dynamic DNS credentials for it. No domain ownership, purchase, or wallet is required, and the hostname is NOT minted as a domain. The key is scoped to this one hostname. The secret is returned ONCE in this response and is never recoverable afterwards — store it immediately.

post/dns/ddns/free-hostnames/claim

Request

  • Base URL: https://api.namefi.io/v-next
  • URL: https://api.namefi.io/v-next/dns/ddns/free-hostnames/claim
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Headers

x-namefi-eip7702-accountstring

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred header name.

x-namefi-eip1271-accountstring

Legacy alias for x-namefi-erc1271-account. When multiple delegated account headers are present, x-namefi-eip7702-account takes precedence, then x-namefi-erc1271-account.

x-namefi-erc1271-accountstring

Optional delegated account address to authenticate as when the signer is an approved signer. Preferred ERC-1271 header name.

Request body

labelstring required
parentDomainstring required
namestring required

Response

OK

Changes

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