Reference

API Reference

NovaDNS exposes two update endpoints: a native token-based API and a DynDNS-compatible endpoint for legacy clients and firmware.

Authentication

Two authentication methods are supported. Both are equivalent in capability.

Token

Recommended

Pass your 64-character host token as the token query parameter. Each host has its own token, rotatable from the dashboard at any time.

Basic Auth

Legacy compat

Use HTTP Basic Auth with the host's username and password (from host settings → Basic Auth credentials in the dashboard). Required by routers and NAS firmware using the DynDNS protocol.

Endpoints

GET / POST/api/update

Native token-based endpoint. Detects your public IP automatically from the incoming request. Optionally accepts an explicit IP via the myip parameter.

curltoken auth

$ curl "https://novadns.io/api/update?token=YOUR_TOKEN"

GET/nic/update

DynDNS-compatible endpoint. Accepts Basic Auth (host username:password) and the standard hostname and myip query parameters. Returns a DynDNS-style response string.

curlbasic auth — DynDNS compat

$ curl \
  "https://YOUR_HOST_USERNAME:YOUR_HOST_PASSWORD@novadns.io/nic/update \
  ?hostname=home.novaip.link&myip=203.0.113.42"

Parameters

ParameterRequiredDescription

tokenyesYour 64-character host update token. Required for /api/update.

hostnamenoThe full hostname to update (e.g. home.novaip.link). Required for /nic/update.

myipnoExplicit IP address or CIDR prefix (IPv4 or IPv6). Auto-detected from request if omitted.

Responses

The native endpoint returns JSON. The DynDNS endpoint returns a plain-text string.

GET /api/update200 OK — JSON

{
  "ipv4": "203.0.113.42",
  "ipv6": "2001:db8::1"
}

GET /nic/update200 OK — DynDNS

good 203.0.113.42

If only IPv4 is detected, ipv6 is null. If only IPv6 is detected, ipv4 is null.

Error codes

400

Bad RequestMissing required parameters, or the myip value is malformed.

401

UnauthorizedInvalid or missing token. Check your token and that it belongs to the correct host.

404

Host not foundNo host matches the provided token or hostname.

429

Rate limitedToo many requests in a short window. Back off and retry.

500

Internal errorSomething went wrong on our end. Check status.novadns.io.

What is DDNS?

DynDNS Compatibility

Was this page helpful?