---
title: "Pause a sandbox"
method: POST
path: "/sandboxes/{id}/pause"
tags: ["Sandboxes"]
---

# Pause a sandbox

`POST /sandboxes/{id}/pause`

Stops the sandbox's container while keeping its workspace volume (if any)
attached. Files under the sandbox's workspace directory survive; RAM state,
running processes, and open sockets do not.

Sandbox must be in status `ready`.

Async, the HTTP response acknowledges the request; `status` transitions
from `ready` to `paused` shortly after.

## Path parameters

- `id` string, required

## Response `200`

Pause queued

- AckMessage
  - `message` string, required

## Other responses

- `400` — Validation error / invalid state transition
- `404` — Sandbox or related resource not found (also returned when owned by another user)

---

[API](https://skmtc.net/brimblehq/apis/brimble-sandbox-api.md) · [All operations](https://skmtc.net/brimblehq/apis/brimble-sandbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brimblehq/brimble-sandbox-api/versions/7fe2df041597/schema)