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

# Stop

`POST /tunnel_sessions/{id}/stop`

Issues a command instructing the ngrok agent that started this tunnel session to exit.

## 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 that started this tunnel session to exit.

## Other responses

- `4XX` — An error. The body carries a machine-readable error_code and a human-readable msg; every code is documented at https://ngrok.com/docs/errors. A 429 with error code ERR_NGROK_226 means the account exceeded the documented request-rate limit.
- `5XX` — An error. The body carries a machine-readable error_code and a human-readable msg; every code is documented at https://ngrok.com/docs/errors. A 429 with error code ERR_NGROK_226 means the account exceeded the documented request-rate limit.

---

[API](https://skmtc.dev/ngrok/apis/ngrok-openapi.md) · [All operations](https://skmtc.dev/ngrok/apis/ngrok-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ngrok/ngrok-openapi/revisions/c697539ac350/schema)