---
title: "Exec Command"
method: POST
path: "/v1/sandboxes/{sandbox_id}/exec"
tags: ["Sandboxes"]
---

# Exec Command

`POST /v1/sandboxes/{sandbox_id}/exec`

Run a command in the sandbox. Streams NDJSON lines (application/x-ndjson): {"stdout": ...}/{"stderr": ...} chunks followed by exactly one terminal {"returncode": N} or {"error": msg} line.

## Path parameters

- `sandbox_id` string, required

## Headers

- `xi-api-key` string, nullable
- `x-api-key` string, nullable

## Request body

- SandboxExecIn
  - `command` string[], required
  - `timeout_seconds` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `409` — Conflict
- `422` — Validation Error

---

[API](https://skmtc.net/deepinfra/apis/deepinfra-api.md) · [All operations](https://skmtc.net/deepinfra/apis/deepinfra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/deepinfra/deepinfra-api/versions/2df28210837a/schema)