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

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