Skip to main content
POST
/
v1
/
processes
Create a long-lived managed process.
curl --request POST \
  --url http://localhost:2468/v1/processes \
  --header 'Content-Type: application/json' \
  --data '
{
  "command": "<string>",
  "args": [
    "<string>"
  ],
  "cwd": "<string>",
  "env": {},
  "interactive": true,
  "tty": true
}
'
{
  "args": [
    "<string>"
  ],
  "command": "<string>",
  "createdAtMs": 123,
  "id": "<string>",
  "interactive": true,
  "owner": "user",
  "status": "running",
  "tty": true,
  "cwd": "<string>",
  "exitCode": 123,
  "exitedAtMs": 123,
  "pid": 1
}

Body

application/json
command
string
required
args
string[]
cwd
string | null
env
object
interactive
boolean
tty
boolean

Response

Started process

args
string[]
required
command
string
required
createdAtMs
integer<int64>
required
id
string
required
interactive
boolean
required
owner
enum<string>
required
Available options:
user,
desktop,
system
status
enum<string>
required
Available options:
running,
exited
tty
boolean
required
cwd
string | null
exitCode
integer<int32> | null
exitedAtMs
integer<int64> | null
pid
integer<int32> | null
Required range: x >= 0