---
title: "POST /v1/sandboxes/{id}/execute"
method: POST
path: "/v1/sandboxes/{id}/execute"
---

# POST /v1/sandboxes/{id}/execute

`POST /v1/sandboxes/{id}/execute`

## Path parameters

- `id` string, required — Sandbox ID

## Request body

- ExecutionRequest
  - `command` string, required — Command to execute (full CLI command, supports shell features like redirection, pipes, etc.)
  - `env` object — Environment variables
  - `timeout` integer — Execution timeout in seconds
  - `working_dir` string — Working directory for execution

## Response `200`

Execution completed

- ExecutionResult
  - `id` string, required — Execution ID
  - `status` 'running' | 'completed' | 'timeout' | 'error', required — Execution status
  - `exit_code` integer, required — Exit code
  - `stdout` string, required — Standard output
  - `stderr` string, required — Standard error output
  - `execution_time_ms` integer, required — Execution time in milliseconds
  - `created_at` string, required — Execution start timestamp
  - `completed_at` string, required — Execution completion timestamp

## Other responses

- `403` — Forbidden - Sandbox does not belong to user
- `404` — Sandbox not found
- `408` — Execution timeout
- `500` — Execution error

## Changes

- **2025-11-25** `ae600162a858` — 1 info
  - added the non-success response with the status `403`

[Change history](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api/changes/v1/sandboxes/:id/execute/post.md)

---

[API](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api.md) · [All operations](https://skmtc.dev/avm-codes/apis/avm-sandbox-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/avm-codes/avm-sandbox-platform-api/revisions/260daed67193/schema)