TektonaTektona
Changelog
DocumentationCLI ReferenceAPI ReferenceSDK Reference
SandboxesSandbox processes

Signal a process

Deliver a signal to the process group. 204 means delivered.

PUT
/v1/sandboxes/{sandboxId}/processes/{ref}/signal

Deliver a signal to the process group. 204 means delivered.

Authorization

apiKey
AuthorizationBearer <token>

API key starting with tektona_. Create one at app-dev.tektona.ai under API Keys.

In: header

Path Parameters

sandboxId*string

Sandbox ID (ULID)

ref*string

Process ULID or name

Query Parameters

resume?boolean

Wake a paused sandbox to serve this request

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

signal*string

Signal to deliver, uppercase, SIG prefix optional

Value in

  • "SIGHUP"
  • "SIGINT"
  • "SIGQUIT"
  • "SIGTERM"
  • "SIGKILL"
  • "SIGUSR1"
  • "SIGUSR2"
  • "SIGSTOP"
  • "SIGCONT"
  • "HUP"
  • "INT"
  • "QUIT"
  • "TERM"
  • "KILL"
  • "USR1"
  • "USR2"
  • "STOP"
  • "CONT"

Response Body

application/problem+json

curl -X PUT "https://example.com/v1/sandboxes/string/processes/string/signal" \  -H "Content-Type: application/json" \  -d '{    "signal": "SIGHUP"  }'
Empty

Toggle process autostart PUT

Enable or disable the persisted autostart definition for the process.

Start a process POST

Start a process in a sandbox. With wait=true, blocks until the process exits (up to wait_timeout_seconds) and returns the finished result; otherwise returns the running process. Always auto-resumes a paused sandbox.