> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wirebox.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Network Tunnel

> Update status and settings for an agent's network tunnel.

### Path Parameters

<ParamField path="handle" type="string" required>
  The agent handle or system tunnel ID (e.g. `support-bot`).
</ParamField>

### Request Body

<ParamField body="status" type="string">
  New tunnel status. Allowed values: `active`, `suspended`, `disabled`.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.wirebox.sh/api/v1/tunnels/support-bot \
    -H "Authorization: Bearer $WIREBOX_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "status": "suspended"
    }'
  ```

  ```python Python theme={null}
  from wirebox import Wirebox

  with Wirebox() as wirebox:
      tunnel = wirebox.tunnels.update("support-bot", status="suspended")
  ```

  ```ts TypeScript theme={null}
  import { Wirebox } from "@wirebox-sh/sdk";

  const wirebox = new Wirebox();
  const tunnel = await wirebox.tunnels.update("support-bot", { status: "suspended" });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "tun_01J8DEF456GHI",
    "agent_id": "ident_01J8ABC123XYZ",
    "agent_handle": "support-bot",
    "public_url": "https://support-bot.wirebox.proxy",
    "status": "suspended",
    "is_connected": false,
    "connected_clients": 0,
    "last_request_at": "2026-09-16T10:30:00Z",
    "created_at": "2026-09-11T10:00:00Z",
    "updated_at": "2026-09-16T11:00:00Z"
  }
  ```
</ResponseExample>