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

Run a full health check of one slot to find why its proxy fails

Use this when a proxy does not work and you need the cause. Checks hardware bus, SIM and radio, interface and IP, data plan egress, DNS, proxy services, rotation readiness and upstream network, and returns each check plus a summary with the most important problem first. Takes several seconds. Only reads state but runs network probes through the modem. tech_diagnostics includes the caller IP and raw logs.

  • Action · reversible
  • Basic auth
  • Panel API · since v21.1.59
  • Hub: routine call
  • diagnoseSlot
POST/v2/diagnose_slot

Request body application/json · required

positionintegerrequired

Slot number (position) on the box, starting at 1. A missing or non-integer value makes the box answer HTTP 500.

Authentication

Needs dashboard Basic credentials when dashboard authentication is enabled; trusted callers (loopback, LAN unless "force auth for local" is on, whitelisted IP, allowed Tailscale) pass without them.

Responses

Diagnosis.

statusbooleanoptional
positionintegeroptional
device_namestringoptional
interfacestringoptional
proxy_portinteger | nulloptional
sock_portinteger | nulloptional
vless_portinteger | nulloptional
ss_portinteger | nulloptional
overall_statusstringoptional
One of passed, warning, error
summaryobjectoptional
checksobject[]optional
checks[].idstringoptional
checks[].namestringoptional
checks[].statusstringoptional
One of passed, warning, error
checks[].valuestringoptional
checks[].badge_textstringoptional
checks[].badge_typestringoptional
checks[].action_typestring | nulloptional
checks[].action_labelstring | nulloptional
checks[].detailstringoptional
tech_diagnosticsobjectoptional

Errors returned in msg

msgMeaningWhat to do
Missing slot positionThe body has no position.Send position as an integer.
Verified against XProxy v21.3.2 on Nov 17, 2026