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

Add a CPE device label and bring up its virtual interface

Use this to register a CPE device. Without VLAN the label must be below 100. The interface is created at once. A missing field or a non-numeric label fails with HTTP 500.

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

Request body application/json · required

labelintegerrequired
manustringrequired
addressstringrequired
vlanbooleanrequired

Responses

Result.

statusbooleanrequired

True when the box accepted the request.

msgstringrequired

Outcome code or message (see the operation's error table).

Errors returned in msg

msgMeaningWhat to do
Label must be less than 100 when VLAN is disabled!Label is 100 or more and vlan is false.Use a smaller label or enable VLAN.
Label already exist!Meant to refuse duplicates; the current check never matches so duplicates are not detected.Check GET /get_label_list before adding.
Verified against XProxy v21.3.2 on Nov 17, 2026