---
search:
  tags:
    - TTS queue
    - POST
seo:
  description: >-
    The undo of start, for when your effect didn't go to plan - the audio…
    Reference for the POST /tts/{orderId}/release endpoint in the TipPage
    Developer API API.
sidebar:
  badge: POST
  label: Release a claimed TTS back to the queue
title: Release a claimed TTS back to the queue
type: openapi-operation
---
The undo of [start](/api/tts-queue/startttsitem), for when your effect didn't go to plan - the audio device failed, your process is shutting down mid-item, the effect errored before anything played. Drops the now-playing claim WITHOUT finishing: the tip stays in the queue at its position, the slot frees, and the tip can be claimed again (by you after recovering, or by any other consumer). Fires `queue.tts.released`. Only drops a claim that actually points at this order id - it can never kick out a different tip's claim, and releasing something you don't hold is a safe no-op (`released: false`). If the tip DID play, use [finish](/api/tts-queue/finishttsitem) instead so it lands in history. Requires `tts:control`.

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