API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Network

Push the current IP to every enabled DDNS provider now

Forces one update of every enabled provider. On boxes with the xddns helper the answer includes per-provider results; older boxes run the update without returning results.

  • Action · reversible
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: routine call
  • triggerAllDdnsUpdates
POST/v2/ddns/trigger_all

Authentication

Needs a trusted caller (loopback, LAN unless "force auth for local" is on, whitelisted IP, allowed Tailscale) or valid dashboard Basic credentials, which are checked only when dashboard authentication is enabled.

Responses

Result.

statusbooleanoptional
msgstringoptional
resultsobject[]optional
results[].typestringoptional
results[].idstringoptional
results[].actionstringoptional
results[].okbooleanoptional
results[].msgstringoptional

Errors returned in msg

msgMeaningWhat to do
trigger_failedThe DDNS helper could not run or read the providers.Check the providers with GET /v2/ddns/providers and retry.
Verified against XProxy v21.3.2 on Nov 17, 2026