Skip to content

REST DELETE profiles id

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

REST: DELETE /profiles/:id

Permanently removes a profile.


Request

DELETE /profiles/:id

Path parameters

Parameter Type Description
id string Profile UUID

No body.


Response

204 No Content — profile deleted.

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

409 Conflict — the profile has a running process. Stop it first with POST /profiles/:id/stop.


Notes

  • Deletion does not stop a running process. The server returns 409 if the profile is currently running.
  • Console log data held in sessionStorage (renderer-side) is not cleared by this endpoint — it will be orphaned until the session ends. This is only relevant when the REST API is used alongside the UI.
  • There is no undo. Deleted profiles cannot be recovered unless you restore the config file from a backup.

Clone this wiki locally