v1

latestOpenAPI 3.1.02026-07-2675394318.9 KB
operation

Kill one subprocess

Sends a signal to the process group of spid inside the running instance. Without the signal parameter the group gets SIGKILL. Termination is observable, not returned: the exit event lands in the event log and GET /operations/{operationId}/subprocesses/{spid} reports the terminal state (signal set, exit_code -1 when killed).

Killing spid=1 (the main process) effectively ends the operation, like letting the command fail.

delete/operations/{operationId}/subprocesses/{spid}

Path parameters

operationIdstring uuid required

A UUID string

Example:12345678-9abc-baba-deda-0123456789ab

The ID of the operation

spidinteger required

Spawn id (1 = main process; ≥2 = exec'd children).

Query parameters

signalstring

Signal to send instead of SIGKILL — a number (15) or a name with or without the SIG prefix (TERM, SIGTERM).

Response

Signal delivered to the subprocess's process group.