---
title: "Let your sandboxes reach each other by name, or stop them."
method: PUT
path: "/v1/networks/private"
tags: ["networks"]
---

# Let your sandboxes reach each other by name, or stop them.

`PUT /v1/networks/private`

## Request

- Base URL: `https://api.withruntime.com`
- URL: `https://api.withruntime.com/v1/networks/private`
- Auth: HTTP bearer

Needs a kept top-up, and free. When on, a program in any of your sandboxes connects to another of your sandboxes at <name>.sandbox.internal:<port> (the name it was created with) or <id>.sandbox.internal:<port>, over TCP, on any port but 10800, 10802 and 10853, which Runtime uses inside every sandbox. A paused sandbox wakes when a connection reaches it. Only your organization's sandboxes answer; nothing else, inside Runtime or out, can reach them this way. Off by default. Turning it off cuts open connections between your sandboxes within seconds.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `enabled` boolean, required: true: your sandboxes reach each other by name. false: they stop, and open connections between them are cut within seconds.

## Response `200`

Success

- object
  - `enabled` boolean, required: Whether your sandboxes reach each other by name now.
  - `suffix` 'sandbox.internal', required: Reach a sandbox at <name>.sandbox.internal or <id>.sandbox.internal.
  - `allowed` boolean, required: Whether this account may turn it on: it must have a kept top-up.
  - `why` string, nullable, required: Why it may not, when allowed is false: not_paid, revoked or suspended.
  - `enabledAt` string, nullable, required: When it was last turned on.
  - `disabledAt` string, nullable, required: When it was last turned off.

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/withruntime/apis/runtime-cloud-api.md) · [All operations](https://skmtc.dev/withruntime/apis/runtime-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withruntime/apis/runtime-cloud-api/revisions/6f4012286988?raw)