REST API

Documentation for the plugin's API, which can be used to create custom controls etc. in other services.

The plugin implements a SimpleAPI as provided by OctoPrint, which enables external access to the plugin's functionality.

It has a single endpoint, supporting a get request and posting a command.

SimpleAPI Get

GET http://octopi.local/api/plugin/ws281x_led_status

Get current state of the plugin, which includes the light status and the torch status.

Headers

Name	Type	Description
X-Api-Key	string	A valid OctoPrint API key.

200 Details of the plugin's current state

{
  "lights_on": false,
  "torch_on": false
}

SimpleAPI Command

POST http://octopi.local/api/plugin/ws281x_led_status

Send commands to the plugin, to make it do something.

Headers

Name	Type	Description
X-Api-Key	string	A valid OctoPrint API key

Request Body

Name	Type	Description
command	string	The command to be sent to the plugin. See commands below.

200

{
  "lights_on": false,
  "torch_on": false
}

See also the SimpleApi docs for details about how the request should be structured.