---
title: "Stop shell connection"
method: POST
path: "/shell/stop"
---

# Stop shell connection

`POST /shell/stop`

## Request

- Base URL: `http://localhost:21721`
- URL: `http://localhost:21721/shell/stop`
- Auth: HTTP bearer

Stops an existing shell session for a connection.

This operation will return once the shell has exited.
If the shell is busy or stuck, you might have to work with timeouts to account for these cases.

## Request body

- ShellStopRequest
  - `store` string, required: The store uuid

## Response `200`

The operation was successful. The shell session was stopped.

## Other responses

- `400`: Bad request. Please check error message and your parameters.
- `401`: Authorization failed. Please supply a `Bearer` token via the `Authorization` header.
- `403`: Authorization failed. Please supply a valid `Bearer` token via the `Authorization` header.
- `500`: Internal error.

---

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