minimusdocs
Help center

Movies

Watch a movie from the dashboard

POST/movies/{id}/preview/

write Change: creates or edits. Scopes

A short-lived link to play the movie yourself. It opens a viewing session, closed with DELETE on the same address (opening another title closes it too). A title played by redirect answers its source link and no session.

Path parameters

  • idstring (uuid)required

    The movie's id.

Response

200 OK

  • urlstringrequired

    The link to open in a player. It works for a short while.

  • session_idstringrequiredcan be null

    The viewing session it opened, to close with DELETE on the same address. Null for a title played by redirect.

  • serverstring

    The playing server's instance id.

  • containerstring
  • video_codecstring
  • audio_codecstring
  • duration_secondsintegercan be null

Errors

  • 400 Something sent is not valid. Each field that is wrong is named with what is wrong.
  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 404 Nothing with this id, or nothing the account can see.
  • 409 No file is ready yet.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.
  • 503 No server can play it now.

What each error means