---
title: "Set router sandbox state"
method: PUT
path: "/public/v2/routers/sandbox/state"
tags: ["Routers"]
---

# Set router sandbox state

`PUT /public/v2/routers/sandbox/state`

## Request

- Base URL: `https://starlink.com/api`
- URL: `https://starlink.com/api/public/v2/routers/sandbox/state`
- Auth: HTTP bearer

Required permission: Device command and configuration, Edit.<br/>Allows disabling or enabling sandboxing on all routers on an account.
When disabled, captive portals are not shown and all WiFi clients have internet access.
After sandboxing is enabled again, the routers' disabled state persists until they reboot or the plane lands.
Use this as a manual fail-safe for an expected enterprise backend outage or an unexpected failure.

## Request body

- SetSandboxStateRequest
  - `sandboxDisabled` boolean: True to disable sandboxing for this account. False enables sandboxing. Defaults to false.

## Response `200`

Success

- ServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean

## Other responses

- `400`: Bad request. Invalid or missing parameter
- `401`: Must use a v2 service account
- `403`: Missing required permission for this endpoint or resource
- `422`: Failed to update sandbox state

## Changes

- **2026-11-02** `dfd7014cfd6d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/starlink/apis/starlink-management-api/changes/public/v2/routers/sandbox/state/put.md)

---

[API](https://skmtc.dev/starlink/apis/starlink-management-api.md) - [All operations](https://skmtc.dev/starlink/apis/starlink-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlink/apis/starlink-management-api/revisions/dfd7014cfd6d?raw)