A CILAMP is controlled via a RESTful web API. This means it is not dependent on any specific programming language nor operating system; you can use it from any environment with internet connection, both in-house and in the cloud.

You configure a CILAMP to follow a certain system identifier, or systemid for short. It is made up of 1-80 characters. Several CILAMPs may use the same system identifier, they will then show the same state.

The systemid can be viewed as the access key of the lamp, as it is all that is needed to control a lamp. So make sure you only share the systemid with those persons and systems that should be able to control the lamp, and do not store it publicly unless you want anyone to be able to change the lamp color. Make it 30+ characters long with random letters and numbers to increase safety, e.g.  use this page to generate 32 character long systemid’s based on words you choose.

A system can be in one of two states:

  1. static. This means any lamp pointing to the system will show a constant color of your choice.
  2. pulsing. Lamps will pulse with a speed and color of your choice.

Static colors give the impression of state of a system or process, e.g. on or off, ready or failed.

Pulsing colors give the impression of something happening, e.g. something is building or being processed.

The meaning of colors and pulses is up to your imagination.

Change state






  color: color specification (format "#RRGGBB")
  period: length of pulse in milliseconds (optional)

Note: the parameters should be transmitted as URL encoded Form Data, i.e. the request header Content-Type should be application/x-www-form-urlencoded‘.

Parameter examples

Set lamp ‘mylamp’ to green

  color: "#00FF00"

Set lamp to red and pulse with 1000ms

  color: "#FF0000"
  period: 1000


Code: 200
{"message": "':systemid' updated"}


Code: 400
{"message": "error message"}

Sample Curl Call

curl -X POST -F "color=#00FF00" "https://api.cilamp.se/v1/testsystem"

Example code

Example code in JavaScript, Java, Python and more can be found here.