---
title: "POST /sandboxes/{sandboxID}/connect"
method: POST
path: "/sandboxes/{sandboxID}/connect"
tags: ["sandboxes"]
---

# POST /sandboxes/{sandboxID}/connect

`POST /sandboxes/{sandboxID}/connect`

Returns sandbox details. If the sandbox is paused, it will be resumed. TTL is only extended.

## Path parameters

- `sandboxID` string, required

## Request body

- ConnectSandbox
  - `timeout` integer, required — Timeout in seconds from the current time after which the sandbox should expire

## Response `200`

The sandbox was already running

- Sandbox
  - `templateID` string, required — Identifier of the template from which is the sandbox created
  - `sandboxID` string, required — Identifier of the sandbox
  - `alias` string — Alias of the template
  - `clientID` string, required — Identifier of the client
  - `envdVersion` string, required — Version of the envd running in the sandbox
  - `envdAccessToken` string — Access token used for envd communication
  - `trafficAccessToken` string, nullable — Token required for accessing sandbox via proxy.
  - `domain` string, nullable — Base domain where the sandbox traffic is accessible

## Other responses

- `201` — The sandbox was resumed successfully
- `400` — Bad request
- `401` — Authentication error
- `404` — Not found
- `500` — Server error

## Changes

- **2026-05-27** `e13ef89d456c` — 1 info
  - the endpoint scheme security `AuthProviderBearerAuth AND AuthProviderTeamAuth` was added to the API
- **2025-11-15** `9fdd20bda2bb` — 2 info
  - added the optional property `trafficAccessToken` to the response with the `200` status
  - added the optional property `trafficAccessToken` to the response with the `201` status
- **2025-10-31** `8ee0d0d1e95e` — 1 info
  - endpoint added
- **2023-11-15** `897ba2f1c7b6` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/e2b-dev/apis/e2b-api/changes/sandboxes/:sandboxID/connect/post.md)

---

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