Commands -- Mesh

POST /api/cmd.mesh.discover

⚠️ Alpha API

Trigger Integrated AP/External AP to scan for default APs.

Available in 8.4.2 or later

Input Parameters

Field	Type	Required	Description
apList	array	✅	List of AP serial numbers to scan

Response

Field	Type	Description
apList	array	List of Capable_AP objects

Capable_AP Object:

Field	Type	Description
serialNumber	string	Serial number of the AP
status	string	online or scanning

cURL Example

curl -b cookies.txt -H "Content-Type: application/json" \
  -X POST -d '{"apList":["19FF-ABCD-1111","19FF-ABCE-2222"]}' \
  http://192.168.1.1/api/cmd.mesh.discover

{
  "stat": "ok",
  "response": {
    "apList": [
      {
        "serialNumber": "19FF-ABCD-1111",
        "status": "scanning"
      },
      {
        "serialNumber": "19FF-ABCE-2222",
        "status": "scanning"
      }
    ]
  }
}

---

GET /api/cmd.mesh.discover.result

⚠️ Alpha API

Retrieve discovery results for default APs.

Available in 8.4.2 or later

Response

Field	Type	Description
apList	array	List of Capable_AP objects
candidateList	array	List of Candidate objects that can accept mesh requests

Capable_AP Object:

Field	Type	Description
serialNumber	string	Serial number of the AP
status	string	online or scanning

Candidate Object:

Field	Type	Description
id	string (MAC)	Candidate ID
bssList	array	List of Discovered_BSS objects
status	string	new or adopting

Discovered_BSS Object:

Field	Type	Description
bssid	string (MAC)	BSSID of the candidate
serialNumber	string	Serial number of scanning AP
rssi	integer	Signal strength observed by the scanning AP
channel	number	Channel number
lastUpdate	number	Time since last update in seconds

cURL Example

curl -b cookies.txt http://192.168.1.1/api/cmd.mesh.discover.result

{
  "stat": "ok",
  "response": {
    "apList": [
      {
        "serialNumber": "19FF-ABCD-1111",
        "status": "scanning"
      },
      {
        "serialNumber": "19FF-ABCE-2222",
        "status": "scanning"
      }
    ],
    "candidates": {
      "order": ["A8:C0:EA:34:C7:A0"],
      "A8:C0:EA:34:C7:A0": {
        "bssList": [
          {
            "bssid": "A8:C1:EA:34:C7:A4",
            "serialNumber": "19FF-ABCD-1111",
            "rssi": -25,
            "channel": 11,
            "lastUpdate": 1
          },
          {
            "bssid": "A8:C1:EA:34:C7:A4",
            "serialNumber": "19FF-ABCE-2222",
            "rssi": -33,
            "channel": 11,
            "lastUpdate": 1
          },
          {
            "bssid": "A8:C1:EA:34:C7:A8",
            "serialNumber": "19FF-ABCD-1111",
            "rssi": -32,
            "channel": 36,
            "lastUpdate": 1
          },
          {
            "bssid": "A8:C1:EA:34:C7:A8",
            "serialNumber": "19FF-ABCE-2222",
            "rssi": -32,
            "channel": 36,
            "lastUpdate": 1
          }
        ],
        "status": "new"
      }
    }
  }
}

---

POST /api/cmd.mesh.request

⚠️ Alpha API

Trigger Integrated AP/External AP to send a mesh request to the target candidate.

Available in 8.4.2 or later

Input Parameters

Field	Type	Required	Description
candidateId	string (MAC)	✅	Target candidate ID

cURL Example

curl -b cookies.txt -H "Content-Type: application/json" \
  -X POST -d '{"candidateId":"00:1A:DD:FF:FF:FF"}' \
  http://192.168.1.1/api/cmd.mesh.request

{
  "stat": "ok"
}