---
title: "Resume a paused sandbox"
method: POST
path: "/sandboxes/{sandbox_id}/resume"
tags: ["Sandboxes"]
---

# Resume a paused sandbox

`POST /sandboxes/{sandbox_id}/resume`

## Request

- Base URL: `https://api-staging.superserve.ai`
- URL: `https://api-staging.superserve.ai/sandboxes/{sandbox_id}/resume`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/superserve-ai/apis/superserve-api/docs/sandboxes/:sandbox_id/resume/post.ts> (a function with typed inputs; its response is checked against the schema)

Restores the sandbox from its paused snapshot. Transitions back to
`active` with all state intact — same memory, same processes, same files.

## Response `200`

Sandbox is now active

- SandboxResponse
  - `id` string, uuid
  - `name` string
  - `status` 'starting' | 'active' | 'pausing' | 'idle' | 'deleted'
  - `vcpu_count` integer
  - `memory_mib` integer
  - `ip_address` string: IP address of the running VM (present when status is active).
  - `snapshot_id` string, uuid: ID of the latest snapshot (present after a pause).
  - `created_at` string, date-time

## Other responses

- `401`: Missing or invalid API key
- `404`: Resource not found
- `409`: Sandbox is not in a valid state for this operation
- `500`: Internal server error

## Changes

- **2026-04-09** `304fe18155b8`: 3 warning, 1 info
  - removed the optional property `metadata` from the response with the `200` status
  - removed the optional property `network` from the response with the `200` status
  - removed the optional property `timeout_seconds` from the response with the `200` status
  - added the optional property `ip_address` to the response with the `200` status

[Operation history](https://skmtc.dev/superserve-ai/apis/superserve-api/changes/sandboxes/:sandbox_id/resume/post.md)

---

[API](https://skmtc.dev/superserve-ai/apis/superserve-api.md) - [All operations](https://skmtc.dev/superserve-ai/apis/superserve-api/llms.txt) - [OpenAPI document](https://skmtc.dev/superserve-ai/apis/superserve-api/revisions/304fe18155b8?raw)