---
search:
  tags:
    - TTS queue
    - POST
seo:
  description: >-
    Promotes the TTS from queue to history and frees the now-playing slot…
    Reference for the POST /tts/{orderId}/finish endpoint in the TipPage
    Developer API API.
sidebar:
  badge: POST
  label: Finish a TTS
title: Finish a TTS
type: openapi-operation
---
Promotes the TTS from queue to history and frees the now-playing slot (when it points at this one). Fires `queue.tts.finished`. Idempotent - finishing an already-gone TTS succeeds with `tip: null`. Finishing means "this played" - if it didn't (your effect failed), use [release](/api/tts-queue/releasettsitem) to put it back instead. Requires `tts:control`.

<Operation source="api" id="finishttsitem" />