Skip to main content

Shutdown

Shutdown​

This request allows triggering a clean shutdown over the API. Since there is no means to restart MistServer afterwards, this command will only be honored when it comes from a local interface. The assumption is that when you have access to the local machine itself, you will also have the means to restart MistServer yourself.

The request looks like this:

{
  "shutdown": "human-readable reason for shutdown here" //Any type will work, conversion to string happens automatically
}

The response is a string as follows:

{
  "shutdown": "Shutting down" //When correctly access over a local interface
  "shutdown": "Ignored - only local users may request shutdown" // When the request is ignored
}

The given shutdown reason will be logged in MistServer logging output during the shutdown for tracability purposes.