Skip to content

Manual Override for Switch Group

This API allows users to manually override the fixture profile settings associated with a Switch and dim the fixtures for a period of time on the floor.


POST https://{em_ip_address_or_hostname}/ems/api/org/switch/v1/op/dimGroup/{floor_id}/{switch_name}/{dimLevel}?time=60 


em_ip_address_or_hostnameManage’s IP address or hostname
floor_idFloor identifier. Use the Get All Floors API, or in EM, select Facility > Floor > in the left panel, and click the Settings tab to obtain the Floor ID.
switch_nameSwitch name. Returned in the Get Switch Groups API. However, note that all switches on the floor are returned.
The recommended path to determine a specific switch name in Manage is select Facility > Floor in the left panel, click Floor Plan tab, and hover the cursor over the switch icon to see the switch name.
dimLevelSpecifies the dim level to which the fixtures in the group should be set to (0-100%, must be a whole number).
timeThe manual override duration time (must be a whole number). The default time is set to 60 minutes.
status0 – Override success;
1 – Override failed.

Sample Request

Manually override fixture profile settings on floor 1 associated with switch ‘SwitchGrp1’ (returned in the Get Switch Groups API) to dim the fixtures for 60 minutes using the Manage server IP address. In the example below, all fixtures controlled by the 'SwitchGrp1' switch on Floor 1 will be dimmed for 60 minutes.


Sample Response

  "status": "0"


Connect and Collaborate with Industrial Professionals and Join the Community!

Click to load comments