Execute a command synchronously

POST /browsers/{id}/process/exec

JavaScript

JavaScript

import Kernel from '@onkernel/sdk';

const client = new Kernel({
  apiKey: process.env['KERNEL_API_KEY'], // This is the default and can be omitted
});

const response = await client.browsers.process.exec('id', { command: 'command' });

console.log(response.duration_ms);

200

{
  "exit_code": 123,
  "stdout_b64": "<string>",
  "stderr_b64": "<string>",
  "duration_ms": 123
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id · string · required

Browser session ID

Body

application/json

Request to execute a command synchronously.

command · string · required

Executable or shell command to run.

args · string[]

Command arguments.

cwd · string | null

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

Pattern: ^/.*

env · object

Environment variables to set for the process.

Show child attributes

as_user · string | null

Run the process as this user.

as_root · boolean · default: false

Run the process with root privileges.

timeout_sec · integer | null

Maximum execution time in seconds.

Response

200

application/json

Execution result

Result of a synchronous command execution.

exit_code · integer

Process exit code.

stdout_b64 · string

Base64-encoded stdout buffer.

stderr_b64 · string

Base64-encoded stderr buffer.

duration_ms · integer

Execution duration in milliseconds.