--- search: tags: - Media queue - POST seo: description: >- The undo of start, for when playback didn't go to plan - the player… Reference for the POST /media/{orderId}/release endpoint in the TipPage Developer API API. sidebar: badge: POST label: Release a claimed media item back to the queue title: Release a claimed media item back to the queue type: openapi-operation --- The undo of [start](/api/media-queue/startmediaitem), for when playback didn't go to plan - the player errored, the video wouldn't load, your process is shutting down mid-item. Drops the now-playing claim WITHOUT finishing: the item stays in the queue at its position, and it can be claimed again. Fires `queue.media.released`. Only drops a claim that actually points at this order id - never a different item's claim - and releasing something you don't hold is a safe no-op (`released: false`). If the item DID play, use [finish](/api/media-queue/finishmediaitem) instead so it lands in history. Requires `media:control`.