---
title: "Execute a command"
method: POST
path: "/sandboxes/{sandboxID}/exec"
tags: ["sandboxes"]
---

# Execute a command

`POST /sandboxes/{sandboxID}/exec`

Run a command inside a sandbox. Set stream=true for streaming output.

## Path parameters

- `sandboxID` string, required

## Request body

- GithubComStacyOsStacyvmInternalOrchestratorExecRequest
  - `args` string[]
  - `command` string
  - `env` object
  - `mode` string
  - `stream` boolean
  - `timeout` string
  - `workdir` string

## Response `200`

OK

- GithubComStacyOsStacyvmInternalOrchestratorExecResult
  - `duration` string
  - `exit_code` integer
  - `stderr` string
  - `stdout` string

## Other responses

- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/stacyos/apis/stacyvm-api.md) · [All operations](https://skmtc.dev/stacyos/apis/stacyvm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stacyos/stacyvm-api/revisions/d8b1ebf10293/schema)