> ## Documentation Index
> Fetch the complete documentation index at: https://tbd-6fc993ce-hypeship-update-create-pool-guidance.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# exec_command

> Run shell commands inside a browser VM

Execute a command synchronously inside a browser VM. Returns decoded stdout, stderr, and the exit code. The `command` field is the executable; pass its arguments in `args`.

## Parameters

| Parameter | Description |
| - | - |
| `session_id` | Browser session ID. Required. |
| `command` | Executable to run (e.g., `cat`, `ls`, `curl`). Required. |
| `args` | Arguments to pass to the command. |
| `cwd` | Working directory (absolute path). |
| `as_root` | Run with root privileges. |
| `timeout_sec` | Max execution time in seconds. |

## Example

```json theme={null}
{
  "session_id": "browser_abc123",
  "command": "curl",
  "args": ["-I", "https://example.com"]
}
```