Content Comparison

http://<<ip address>>/rest/controller/«controllerno»/tag/

PUT

Sets value and color on a range of tags.

controllerno is a number

[
  {
    "tagid": «tagid»,
    "value": «valuetodisplay»,
    ["color": "red|green|orange|blue|pink|cyan|none"]
  },
  ...
]

color is optional. When no color is chosen, it defaults to red.

value should be a string.

All In v2.1.1, all tags are switched off before the range is set, this means sending [] causes all tags to be switched off.

In v2.1.2+, you need to handle the switching off of tags by yourself, using the cabinet/lightest call (when used with off, this switches off all lights).

HTTP204 when successful

HTTP400 when request was invalid

{
  "message": «human readable error»
}

HTTP404 with no body when controller does not exist

HTTP409 when cabinet not in correct mode

Note when the cabinet sides setting is set to frontonly, controller 2 will not be available and this will result in an HTTP404.

New in version 2.1.0.