minimusdocs
Help center

Watch folders

Browse a server's folders

GET/vod/watch-folders/browse/

read Read: looks, changes nothing. Scopes

One folder of a server: in its incoming folder (root: incoming, path relative to it) or its media folders (root: media; path empty lists them). Buckets are browsed under Settings → Storage.

Query parameters

  • pathstring
  • rootstring

    incoming by default.

    One of: "incoming" "media"

  • serverstring (uuid)required

    A server that keeps movies and episodes.

  • sourcestring

    Only node (a server).

    One of: "node"

Response

200 OK

  • pathstringrequired

    Where this is; empty at the top.

  • parentstringrequiredcan be null

    The folder above; null at the top.

  • entriesobject[]required
    • pathstringrequired

      What to send back: relative to the incoming folder, or absolute in a media folder.

    • namestringrequired
    • is_dirbooleanrequired
    • size_bytesintegerrequired
  • truncatedbooleanrequired

    The listing was cut short.

  • rootstring

    incoming or media, when asked for media.

Errors

  • 400 Refused, with the reason in detail.
  • 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