v97

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-31135175384.2 KB
Browser Processes

Execute a command asynchronously

post/browsers/{id}/process/spawn

Path parameters

idstring required

Browser session ID

Request body

commandstring required

Executable or shell command to run.

argsstring[]

Command arguments.

cwdstring nullable

Working directory (absolute path) to run the command in.

envobject

Environment variables to set for the process.

as_userstring nullable

Run the process as this user.

as_rootboolean

Run the process with root privileges.

timeout_secinteger nullable

Maximum execution time in seconds.

allocate_ttyboolean

Allocate a pseudo-terminal (PTY) for interactive shells.

rowsinteger

Initial terminal rows. Only used when allocate_tty is true.

colsinteger

Initial terminal columns. Only used when allocate_tty is true.

Response

Spawned

process_idstring uuid

Server-assigned identifier for the process.

pidinteger

OS process ID.

started_atstring date-time

Timestamp when the process started.