POST/api/v1/runs/{runId}/stop
Sends SIGTERM to the container so the shutdown reconcile sweep
captures any final file changes. Fires the completion webhook (if
callbackUrl was set). Idempotent — already-stopped runs return 200
with alreadyStopped: true.
Authentication
Requires a project API key — see Authentication.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
runId | path | string | required | UUID of the run. |
Responses
| Status | Description |
|---|---|
200 | Already stopped. |
202 | Stop signal sent. |
404 | Resource not found or not accessible to this project. |
Tag: Interactions