---
title: "Restart"
method: POST
path: "/tunnel_sessions/{id}/restart"
tags: ["TunnelSessions"]
---

# Restart

`POST /tunnel_sessions/{id}/restart`

Issues a command instructing the ngrok agent to restart. The agent restarts itself by calling exec() on platforms that support it. This operation is notably not supported on Windows. When an agent restarts, it reconnects with a new tunnel session ID.

## Path parameters

- `id` string, required

## Headers

- `ngrok-version` integer, required

## Request body

- Item
  - `id` string — a resource identifier

## Response `204`

Issues a command instructing the ngrok agent to restart. The agent restarts itself by calling exec() on platforms that support it. This operation is notably not supported on Windows. When an agent restarts, it reconnects with a new tunnel session ID.

---

[API](https://skmtc.net/ngrok/apis/ngrok-openapi.md) · [All operations](https://skmtc.net/ngrok/apis/ngrok-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ngrok/ngrok-openapi/versions/1994bbb04714/schema)