Docs

API: Wi-Fi Management

1. Switch to a Specific Wi-Fi Network

Switches the device connected to a test session to a specific Wi-Fi SSID.

Method: PUT

URL: http://<RobusTest URL>/v3/testsession/<testsession_id>/changewifi?accesskey=<access key>

Payload:

{
  "ssid": "<ssid value>",
  "password": "<password value>"
}
Field Description
ssid The SSID of the Wi-Fi network to switch to
password The password for the target Wi-Fi network

Example:

PUT http://<RobusTest URL>/v3/testsession/5f3c2a1b4e7d890abc123456/changewifi?accesskey=<access key>

{
  "ssid": "OfficeNetwork",
  "password": "testpassword123"
}

2. Get Wi-Fi History for a Device

Returns the Wi-Fi connection history for a specific device — showing SSID changes over time.

Method: GET

URL: http://<RobusTest URL>/v3/device/<device_id>/wifihistory?accesskey=<access key>

Query Parameters

Parameter Required Description
count No Number of history records to return. Omit to return all records.
start No Start of date range. Format: MM-DD-YYYY:HH:MM:SS. When provided, end is also required.
end No End of date range. Format: MM-DD-YYYY:HH:MM:SS.

Note: If start and end are provided, all records within that date range are returned and count is ignored.

Response

Returns an array of Wi-Fi history records:

[
  {
    "_id": "<history record id>",
    "device": "<device id>",
    "ssid": "<current ssid>",
    "oldSSID": "<previous ssid>",
    "isEnabled": true,
    "created": "<timestamp>"
  }
]
Field Description
device The RobusTest device ID
ssid The SSID the device switched to
oldSSID The SSID the device was on before the switch
isEnabled Whether Wi-Fi was enabled at this point
created Timestamp of when the Wi-Fi change was recorded

Example — get last 5 records:

GET http://<RobusTest URL>/v3/device/5f3c2a1b4e7d890abc123456/wifihistory?count=5&accesskey=<access key>

Example — get records within a date range:

GET http://<RobusTest URL>/v3/device/5f3c2a1b4e7d890abc123456/wifihistory?start=04-01-2026:00:00:00&end=04-14-2026:23:59:59&accesskey=<access key>