Skip to content

REST POST profiles id input

Timon Home edited this page Mar 19, 2026 · 1 revision

REST: POST /profiles/:id/input

Sends a string to the stdin of the running process.


Request

POST /profiles/:id/input
Content-Type: application/json

Path parameters

Parameter Type Description
id string Profile UUID

Body

{
  "input": "stop"
}
Field Type Required Description
input string Yes Command string to write to stdin

A newline character is automatically appended if the string does not already end with one.


Response

200 OK

{
  "ok": true
}

400 Bad Request — process is not running:

{
  "ok": false,
  "error": "Not running"
}

404 Not Found — no profile with the given id exists.


Notes

The input is also echoed to the console output stream as a type: "input" line, consistent with input sent from the UI. This means it will appear in the activity visible to the renderer if the UI is open.

Useful for sending commands to interactive processes such as Minecraft servers (stop, say Hello), Spring Boot actuators that read from stdin, or any REPL-style Java application.

Clone this wiki locally