minimusdocs
Help center

Settings

Get VOD settings

GET/settings/vod/

read Read: looks, changes nothing. Scopes

Movie and TV show settings: the TMDB key and language for details and posters, the storage bucket for video files, and how long playback and upload links last. The TMDB key is never returned: tmdb_configured says whether one is set. Panel operators only.

Response

200 OK

  • tmdb_configuredbooleanrequiredread-only
  • tmdb_languagestring

    Language for plots and titles, e.g. en-US, fr-FR, ar-SA.

  • tmdb_image_basestring

    Prefix for poster and backdrop paths. The trailing size segment (w500, original, ...) decides how large the stored artwork URLs are.

  • s3_storagestring (uuid)can be null

    The bucket movies are browsed and read from. Empty turns the object-storage source off. Buckets are added under Settings → Storage.

  • s3_storage_namestringrequiredread-only
  • s3_configuredbooleanrequiredread-only
  • s3_presign_ttlinteger

    How long a signed download link stays valid. It must outlast the transfer itself: if it expires mid-download, a node resuming a large file is refused partway through. Default 6 hours.

  • ticket_expirationinteger

    How long a movie link stays valid once a viewer opens it. Longer than a live token by necessity — a seeking player reopens the connection on every scrub, so the link has to survive a whole film. This is the blast-radius control: shorten it if a shared link matters more than a viewer having to reopen a long movie. Default 4 hours.

  • upload_chunk_mbinteger

    How much of a file the browser sends per request when you upload a movie. Smaller loses less to a dropped connection; larger means fewer round trips. Streaming servers refuse chunks above their own limit (16 MB unless changed on the server). Default 8 MB.

  • upload_ticket_expirationinteger

    How long a browser may keep sending one upload. It has to outlast the upload itself — a 40 GB file on a slow line takes hours — but it authorises writes, so not much longer. Default 6 hours.

  • replica_ticket_expirationinteger

    How long one streaming server may pull a movie from another when copying it. Fast links, but a large library copied one file at a time can take a while. Default 24 hours.

  • updated_atstring (date-time)requiredread-only

Errors

  • 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.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means