warp CS API documentation

/v3/dns/dyndns

A dynamic DNS updater endpoint.

URL Parameters

Name Type Description Required Default value
zone string The DNS zone name. yes -
subdomain string The subdomain name. This name is prepended to the zone parameter to form the full domain name being updated. This value may be "@" to specify the zone apex. yes -
ipaddr string The IP address to set. May be "auto" to use the client IP address as the new value, and "auto4" or "auto6" to constrain the IP address version to either IPv4 or IPv6, respectively (if the client connects using the other procotol, an error is returned). yes -

Authentication

This endpoint requires a domain key for authentication, which must be sent as the value in a x-domain-auth header or query parameter, or authorization: bearer header. This key is available in the Hosting Management Interface for a domain you host at warpcs.org: "Internet Resources" -> "Domains (ICANN)" -> [your domain name] -> "Manage" -> "Domain Key" -> "Show Domain Key".

Request Body

The request body is ignored.

Response Body

If successful, the response will have status code 204.

Restrictions

Rate Limit: 5 requests per 5s

API access must be enabled in the domain settings.