---
title: "Release a Gladia live session that was never bridged"
method: POST
path: "/v1/dictation/live/release"
tags: ["Desktop"]
---

# Release a Gladia live session that was never bridged

`POST /v1/dictation/live/release`

## Request

- Base URL: `https://api.quillhub.ai`
- URL: `https://api.quillhub.ai/v1/dictation/live/release`
- Auth: HTTP bearer

Sends stop_recording to the Gladia session named by the ticket, over a plain server-to-server WebSocket, and closes it. Deliberately plain HTTPS on this endpoint's own side — not a WebSocket the client has to open — because the failure mode it exists for is a session created via POST /v1/dictation/live whose relay WebSocket never bridged (network blocks the WS upgrade, the client crashed between create and connect, and similar). A WS-based release would be unavailable in exactly that case. Reuses the same ticket embedded in `relay_url`'s `ticket` query param — no separate credential. Idempotent: releasing an already-closed session is not an error. Accepts a ticket whose signature is valid but whose 60s `exp` has already passed, within a 15-minute grace window — the dominant trigger for release is a 4401 relay close, which IS an expired ticket, so strict expiry here would make the fix for that case fail on exactly the ticket it needs to release. Requires `Authorization: Bearer <token>` like every other route on this router, and additionally checks that the ticket's `user_id` matches the authenticated caller — required once expired tickets are accepted, so a replayed ticket can only ever stop the presenting caller's own session.

## Request body

- object
  - `ticket` string, required

## Response `200`

Release attempted (idempotent).

- object
  - `released` boolean, required

## Other responses

- `401`: Unauthenticated, ticket malformed/badly signed, or expired beyond the release grace window.
- `403`: Ticket was not issued to the authenticated user.
- `429`: Too many release requests.
- `503`: Relay unconfigured.

---

[API](https://skmtc.dev/quillhub/apis/quillhub-public-api.md) · [All operations](https://skmtc.dev/quillhub/apis/quillhub-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/quillhub/apis/quillhub-public-api/revisions/5bd42ee9d967?raw)