---
title: "Create a voice chat session"
method: POST
path: "/v1/voice-chat/session"
tags: ["Voice Chat"]
---

# Create a voice chat session

`POST /v1/voice-chat/session`

## Request

- Base URL: `http://localhost:9998`
- URL: `http://localhost:9998/v1/voice-chat/session`
- Auth: HTTP bearer

Starts a new voice chat session. Returns the session ID and start timestamp.

## Response `200`

Session created

- VoiceChatSession
  - `sessionId` string, uuid, required: Unique session identifier
  - `startedAt` string, date-time, required: ISO 8601 timestamp when the session started

## Other responses

- `503`: Voice chat service not ready

---

[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)