---
title: "Start the pose stream WebSocket server"
method: POST
path: "/v1/pose/stream/start"
tags: ["Pose"]
---

# Start the pose stream WebSocket server

`POST /v1/pose/stream/start`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/pose/stream/start`
- Auth: HTTP bearer

Starts the dedicated WebSocket server for real-time pose streaming.
The server prefers port 10005 but falls back to an OS-assigned port if
10005 is occupied. The response includes the actual port and endpoint URL.

Idempotent — calling start when already running returns the current port.

## Response `200`

WebSocket server started (or already running)

- object
  - `running` boolean
  - `port` integer: The actual port the WebSocket is listening on
  - `endpoint` string: Full WebSocket URL, e.g. ws://127.0.0.1:10005

---

[API](https://skmtc.dev/modelpiper/apis/toolpiper-api.md) · [All operations](https://skmtc.dev/modelpiper/apis/toolpiper-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modelpiper/apis/toolpiper-api/revisions/6722bf56385c?raw)