Video files

Browse a server's incoming folder

GET/vod/browse/

read Read: looks, changes nothing. Scopes

One folder of a server's incoming folder, to pick a file a movie or an episode uses as it is (…/adopt-file/). Panel operators only.

Query parameters

  • pathstring

    Relative to the incoming folder; empty for its top.

  • serverstring (uuid)required

    The server.

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

  • 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.
  • 502 The server could not be reached.

What each error means