Start a managed process (outlives the request)

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Start a process the guest agent owns. Returns as soon as the fork succeeds — the process outlives this request, unlike /exec, which SIGKILLs its process group on return.

cmd*|array<string>

Command as argv array, or a string run via sh -c.

cwd?string

Defaults to "/". Must exist.

env?

Merged over the sandbox's own envVars, which are injected automatically.

pty?boolean

Allocate a PTY. stdout and stderr are then inherently merged: everything arrives on stdout and stderr stays empty.

cols?integer

Range1 <= value <= 1000

rows?integer

Range1 <= value <= 1000

timeout_ms?integer

0 = no timeout. Above 0 the guest SIGKILLs the group at the deadline and marks the record timed_out.

Range0 <= value <= 86400000

Default0

Response Body

`application/json`

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

{  "handle": "string",  "pid": 0,  "pty": true}

Empty

Authorization

Path Parameters

Request Body

Response Body

201application/json

401

`application/json`