List DynDNS update logs
GET /api/v2/domains/{id}/dyndns/{configId}/logs
Lists the latest 50 update attempts for one DynDNS configuration, newest first. Each entry shows the old and new address, where the request came from and whether it worked. Use it when a router or DynDNS client does not change the record as expected. Only updates that match this configuration’s host name and token are logged: a wrong token or host name, or an update refused for too many requests, leaves no entry. Entries older than 30 days are removed.
Authentication: An API key with the scope read:domains. About keys and scopes
Request
Path parameters
idstringrequiredThe domain ID (
dom_…).configIdstringrequiredThe DynDNS configuration ID (
ddns_…) from configs[].id on GET /api/v2/domains/{id}/dyndns.Example
curl "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/dyndns/ddns_01hxa3b4c5d6e7f8g9h0j1k2m3/logs" \ -H "Authorization: Bearer $HOSTUP_API_KEY"Responses
200 The latest update attempts.
{ "logs": [ { "oldIp": "198.51.100.40", "newIp": "198.51.100.45", "sourceIp": "198.51.100.45", "userAgent": "ddclient/3.11.2", "status": "success", "errorMessage": null, "createdAt": "2026-04-27T12:00:00.000Z" } ]}Response fields
logsarray of objectUpdate attempts, newest first.
oldIpstring | nullThe address before the update.
newIpstring | nullThe address the record was set to. Null when the update failed.
sourceIpstring | nullThe address the update request came from.
userAgentstring | nullThe
User-Agent of the client that sent the update.statusstringsuccess (the record changed), no_change (the address was already set), failed or unknown. One of success, no_change, failed, unknown.errorMessagestring | nullWhy the update failed, or a note on a successful update (for example that a missing record was recreated). Null otherwise. IP addresses, URLs and internal host names are masked.
createdAtstring | nullWhen the update arrived.
Errors
Errors are Problem Details with a stable code. Branch on the code, not on the text.
| 401 | Unauthorized. Authentication is required. |
| 403 | Forbidden. The caller lacks a required scope or does not own the resource. |
| 404 | The domain or the configuration was not found. code is domain_not_found for the domain, dyndns_config_not_found for an unknown configuration ID, and not_found for a configuration that was deleted or is not on this domain. |
| 429 | Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers. |
| 500 | Internal error. Retry later or contact support if the issue persists. |