REST DELETE processes pid

REST: DELETE /processes/:pid

Force-kills a process by PID. Works on any process — managed or unmanaged.

---

Request

DELETE /processes/:pid

Path parameters

Parameter	Type	Description
pid	number	OS process ID

No body.

---

Response

200 OK

{
  "ok": true
}

400 Bad Request — pid is not a valid number.

500 Internal Server Error — kill command failed (process may have already exited, or insufficient permissions):

{
  "ok": false,
  "error": "Access is denied."
}

---

Platform behaviour

OS	Method
Windows	taskkill /PID {pid} /T /F — kills entire process tree
Unix	SIGKILL via process.kill(pid, 'SIGKILL')

---

Notes

If the PID matches a JRC-managed process, that entry is removed from the internal process map and a state update is broadcast to the renderer. This keeps the UI in sync when killing managed processes via the REST API.

This is a force-kill. The target process has no opportunity for graceful shutdown. Use POST /profiles/:id/stop instead when terminating a JRC-managed process that may need to clean up (e.g. flush data, run shutdown hooks).