9.4 Update Device status

POST https://{{domain}}/api/v2/device/status

Update the status of the device to reflect the current state. The status is transient so it overwrites the last recorded status.

Request

JSON object

  • DeviceGUID (guid, required)
  • Status (enum, optional): Error, Idle, Offline, Aborting, Printing, Sleeping, Calibrating, Maintenance, Pause, NotUsed, Hold
  • Message (string, optional): free form human readable status message
  • Temperature (int, optional): heater temperature in celsius
  • ConnectionState (enum, optional): status from the PING messages, one of “Online”, “Offline”, “Unstable”
  • ConnectionMessage (string, optional): Freeform human readable connection status message
  • RemainingInks (JSON object, optional)
    • InkIndex (int, optional): sequence index of the ink
    • InkName (string, required): Name of the ink color
    • Level (int, optional): Current amount of ml of the tank, <0 indicates unknown
    • MaxLevel (int, optional): Max amount of ml of the tank
  • QueueLength (JSON object, optional)
    • Type (enum, required): Unknown, Length, Area, Sheet
    • Value (int, required)

Response

200 OK

"Device status successfully updated"