---
title: "Batch update sandbox clients"
method: POST
path: "/public/v2/routers/sandbox/clients"
tags: ["Routers"]
---

# Batch update sandbox clients

`POST /public/v2/routers/sandbox/clients`

Required permission: Device command and configuration, Edit.<br/>Update the sandbox state for multiple clients. If sandboxing is enabled, sandboxed clients will only have access to domains in the sandbox domain allow list. If a client is duplicated, records the client with the latest expiry.

## Request body

- UpdateBatchSandboxClientRequest[]
  - `clientId` string, required — Identifier of the client to add or remove from a sandbox.
  - `sandboxId` integer, required — Identifier used to separate sandbox environments. Per-client sandboxing is shared within the same SandboxId.
  - `expiry` string, date-time, required — Expiry of the sandbox state as a UTC date time.

## 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` — Unauthorized
- `403` — Missing required permission for this endpoint or resource
- `422` — Failed to update sandbox clients

---

[API](https://skmtc.net/starlink/apis/starlink-management-api.md) · [All operations](https://skmtc.net/starlink/apis/starlink-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/starlink/starlink-management-api/revisions/a730bd0ddb42/schema)