API Reference
Dashboard
  1. API Reference
  2. Box API
  3. Rotation settings

Save the global rotation settings (full replace of the main fields)

Use this to change rotation timing, collision handling, duplicate-IP rotation, Smart IP Guard or the IMEI/MAC changer. Read GET /v2/rotation_setting first and send the whole object back with your change: the timing fields, detect_collision_ip, imei_changer and mac_changer are required, and missing duplicate-IP fields are reset to their defaults (off, 30 seconds, 5 attempts). Smart IP Guard fields, never_change_ip_automatically and reconnect_ipv6_failure are saved only when present. Takes effect immediately for all slots. A missing required field or a non-numeric main value fails with HTTP 500 before anything is saved; a non-numeric Smart IP Guard value fails with HTTP 500 after the main fields were already saved.

  • Destructive · confirm first
  • Basic auth
  • Panel API · since v20.8.0
  • Hub: needs owner approval
  • setRotationSettings
POST/v2/rotation_setting

Request body application/json · required

rotation_delay_before_processnumberrequired
prevent_time_each_portintegerrequired
delay_rotation_timenumberrequired
delay_rotation_android_timenumberrequired
reconnect_isp_failure_timeintegerrequired
reconnect_isp_failure_max_retryintegerrequired
detect_collision_ipbooleanrequired
never_change_ip_automaticallyboolean | stringoptional

true/false or 1/0, on/off.

reconnect_ipv6_failureboolean | stringoptional
duplicate_ip_rotate_individual_enabledbooleanoptional
Default false
duplicate_ip_rotate_individual_wait_secondsintegeroptional
Default 30
duplicate_ip_rotate_individual_max_attemptsintegeroptional
Default 5
duplicate_ip_rotate_all_modems_enabledbooleanoptional
Default false
duplicate_ip_rotate_all_modems_wait_secondsintegeroptional
Default 30
duplicate_ip_rotate_all_modems_max_attemptsintegeroptional
Default 5
ip_history_guard_enabledbooleanoptional
ip_history_guard_time_window_hoursintegeroptional
ip_history_guard_max_retriesintegeroptional
ip_history_guard_backoff_delayintegeroptional
ip_history_guard_score_thresholdintegeroptional
ip_history_guard_fresh_scoreintegeroptional
ip_history_guard_auto_stop_enabledbooleanoptional
ip_history_guard_auto_resume_secondsintegeroptional
imei_changerobjectrequired
imei_changer.phone_modelsany[]required
imei_changer.based_imeistringoptional

Base IMEIs separated by new lines.

imei_changer.imei_changer_optionintegerrequired
mac_changerobjectrequired
mac_changer.mac_changer_optionintegerrequired
mac_changer.based_addressstringoptional

Base MAC addresses separated by new lines.

Responses

Saved.

statusbooleanoptional

Errors returned in msg

msgMeaningWhat to do
never_change_ip_automatically must be true or falseThe switch value is not a boolean or a known spelling.Send true or false.
reconnect_ipv6_failure must be true or falseThe switch value is not a boolean or a known spelling.Send true or false.
Verified against XProxy v21.3.2 on Nov 17, 2026