Update from a script (curl, PowerShell)
November 19, 2026
Update your hostname with a single request from Linux, macOS or Windows.
An update is one HTTPS request to the update address. If you leave out the myip parameter, Shift DNS uses the IP address the request comes from, so a script on a machine behind your router needs no other tool.
curl (Linux, macOS)
curl -fsS -H "Authorization: Bearer thdns_xxxxxxxx" "https://api.shiftdns.thunderhosting.com/nic/update?hostname=your-hostname"To run it every 5 minutes, add this line with crontab -e:
*/5 * * * * curl -fsS -H "Authorization: Bearer thdns_xxxxxxxx" "https://api.shiftdns.thunderhosting.com/nic/update?hostname=your-hostname" >/dev/null 2>&1PowerShell (Windows)
Invoke-RestMethod -Uri "https://api.shiftdns.thunderhosting.com/nic/update?hostname=your-hostname" -Headers @{ Authorization = "Bearer thdns_xxxxxxxx" }To run it every 5 minutes, open PowerShell as administrator and register a scheduled task:
$cmd = 'Invoke-RestMethod -Uri "https://api.shiftdns.thunderhosting.com/nic/update?hostname=your-hostname" -Headers @{ Authorization = "Bearer thdns_xxxxxxxx" }'
$action = New-ScheduledTaskAction -Execute "powershell.exe" -Argument "-NoProfile -WindowStyle Hidden -Command $cmd"
$trigger = New-ScheduledTaskTrigger -Once -At (Get-Date) -RepetitionInterval (New-TimeSpan -Minutes 5)
Register-ScheduledTask -TaskName "ShiftDNS" -Action $action -Trigger $triggerParameters
| Parameter | Meaning |
|---|---|
| hostname | The hostname to update. Several hostnames separated by commas are possible (up to 5 per request). |
| myip | The IPv4 or IPv6 address to set. Optional: without it, the address of the request is used. |
| myipv6 | An additional IPv6 address. Optional. |
Only public IP addresses are accepted. Private addresses such as 192.168.x.x are refused.