FlowAlp

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)

bash
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:

bash
*/5 * * * * curl -fsS -H "Authorization: Bearer thdns_xxxxxxxx" "https://api.shiftdns.thunderhosting.com/nic/update?hostname=your-hostname" >/dev/null 2>&1

PowerShell (Windows)

powershell
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:

powershell
$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 $trigger

Parameters

ParameterMeaning
hostnameThe hostname to update. Several hostnames separated by commas are possible (up to 5 per request).
myipThe IPv4 or IPv6 address to set. Optional: without it, the address of the request is used.
myipv6An additional IPv6 address. Optional.

Only public IP addresses are accepted. Private addresses such as 192.168.x.x are refused.